diff --git a/datafusion/.buildinfo b/datafusion/.buildinfo deleted file mode 100644 index 007a5beeff43..000000000000 --- a/datafusion/.buildinfo +++ /dev/null @@ -1,4 +0,0 @@ -# Sphinx build info version 1 -# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 1b4aead2ffa1d1fb31cc7267dcb79c76 -tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/datafusion/.gitignore b/datafusion/.gitignore deleted file mode 100644 index 97d0badbd313..000000000000 --- a/datafusion/.gitignore +++ /dev/null @@ -1 +0,0 @@ -_sources \ No newline at end of file diff --git a/datafusion/_downloads/3cce4d737d8c5814f5b50d859d21ba53/capitalized_example.csv b/datafusion/_downloads/3cce4d737d8c5814f5b50d859d21ba53/capitalized_example.csv deleted file mode 100644 index dbc8f5c5a0a6..000000000000 --- a/datafusion/_downloads/3cce4d737d8c5814f5b50d859d21ba53/capitalized_example.csv +++ /dev/null @@ -1,5 +0,0 @@ -A,b,c -1,2,3 -1,10,5 -2,5,6 -2,1,4 \ No newline at end of file diff --git a/datafusion/_downloads/9f6fbc67bd5c63cb1fd7ba4efdf82d7a/example.csv b/datafusion/_downloads/9f6fbc67bd5c63cb1fd7ba4efdf82d7a/example.csv deleted file mode 100644 index 0eadb69396b3..000000000000 --- a/datafusion/_downloads/9f6fbc67bd5c63cb1fd7ba4efdf82d7a/example.csv +++ /dev/null @@ -1,2 +0,0 @@ -a,b,c -1,2,3 \ No newline at end of file diff --git a/datafusion/_static/DataFusion-Logo-Background-White.png b/datafusion/_static/DataFusion-Logo-Background-White.png deleted file mode 100644 index 023c2373fc49..000000000000 Binary files a/datafusion/_static/DataFusion-Logo-Background-White.png and /dev/null differ diff --git a/datafusion/_static/_sphinx_javascript_frameworks_compat.js b/datafusion/_static/_sphinx_javascript_frameworks_compat.js deleted file mode 100644 index 8549469dc29f..000000000000 --- a/datafusion/_static/_sphinx_javascript_frameworks_compat.js +++ /dev/null @@ -1,134 +0,0 @@ -/* - * _sphinx_javascript_frameworks_compat.js - * ~~~~~~~~~~ - * - * Compatability shim for jQuery and underscores.js. - * - * WILL BE REMOVED IN Sphinx 6.0 - * xref RemovedInSphinx60Warning - * - */ - -/** - * select a different prefix for underscore - */ -$u = _.noConflict(); - - -/** - * small helper function to urldecode strings - * - * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL - */ -jQuery.urldecode = function(x) { - if (!x) { - return x - } - return decodeURIComponent(x.replace(/\+/g, ' ')); -}; - -/** - * small helper function to urlencode strings - */ -jQuery.urlencode = encodeURIComponent; - -/** - * This function returns the parsed url parameters of the - * current request. Multiple values per key are supported, - * it will always return arrays of strings for the value parts. - */ -jQuery.getQueryParameters = function(s) { - if (typeof s === 'undefined') - s = document.location.search; - var parts = s.substr(s.indexOf('?') + 1).split('&'); - var result = {}; - for (var i = 0; i < parts.length; i++) { - var tmp = parts[i].split('=', 2); - var key = jQuery.urldecode(tmp[0]); - var value = jQuery.urldecode(tmp[1]); - if (key in result) - result[key].push(value); - else - result[key] = [value]; - } - return result; -}; - -/** - * highlight a given string on a jquery object by wrapping it in - * span elements with the given class name. - */ -jQuery.fn.highlightText = function(text, className) { - function highlight(node, addItems) { - if (node.nodeType === 3) { - var val = node.nodeValue; - var pos = val.toLowerCase().indexOf(text); - if (pos >= 0 && - !jQuery(node.parentNode).hasClass(className) && - !jQuery(node.parentNode).hasClass("nohighlight")) { - var span; - var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); - if (isInSVG) { - span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); - } else { - span = document.createElement("span"); - span.className = className; - } - span.appendChild(document.createTextNode(val.substr(pos, text.length))); - node.parentNode.insertBefore(span, node.parentNode.insertBefore( - document.createTextNode(val.substr(pos + text.length)), - node.nextSibling)); - node.nodeValue = val.substr(0, pos); - if (isInSVG) { - var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); - var bbox = node.parentElement.getBBox(); - rect.x.baseVal.value = bbox.x; - rect.y.baseVal.value = bbox.y; - rect.width.baseVal.value = bbox.width; - rect.height.baseVal.value = bbox.height; - rect.setAttribute('class', className); - addItems.push({ - "parent": node.parentNode, - "target": rect}); - } - } - } - else if (!jQuery(node).is("button, select, textarea")) { - jQuery.each(node.childNodes, function() { - highlight(this, addItems); - }); - } - } - var addItems = []; - var result = this.each(function() { - highlight(this, addItems); - }); - for (var i = 0; i < addItems.length; ++i) { - jQuery(addItems[i].parent).before(addItems[i].target); - } - return result; -}; - -/* - * backward compatibility for jQuery.browser - * This will be supported until firefox bug is fixed. - */ -if (!jQuery.browser) { - jQuery.uaMatch = function(ua) { - ua = ua.toLowerCase(); - - var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || - /(webkit)[ \/]([\w.]+)/.exec(ua) || - /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || - /(msie) ([\w.]+)/.exec(ua) || - ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || - []; - - return { - browser: match[ 1 ] || "", - version: match[ 2 ] || "0" - }; - }; - jQuery.browser = {}; - jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; -} diff --git a/datafusion/_static/basic.css b/datafusion/_static/basic.css deleted file mode 100644 index 18495ea08848..000000000000 --- a/datafusion/_static/basic.css +++ /dev/null @@ -1,900 +0,0 @@ -/* - * basic.css - * ~~~~~~~~~ - * - * Sphinx stylesheet -- basic theme. - * - * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/* -- main layout ----------------------------------------------------------- */ - -div.clearer { - clear: both; -} - -div.section::after { - display: block; - content: ''; - clear: left; -} - -/* -- relbar ---------------------------------------------------------------- */ - -div.related { - width: 100%; - font-size: 90%; -} - -div.related h3 { - display: none; -} - -div.related ul { - margin: 0; - padding: 0 0 0 10px; - list-style: none; -} - -div.related li { - display: inline; -} - -div.related li.right { - float: right; - margin-right: 5px; -} - -/* -- sidebar --------------------------------------------------------------- */ - -div.sphinxsidebarwrapper { - padding: 10px 5px 0 10px; -} - -div.sphinxsidebar { - float: left; - width: 270px; - margin-left: -100%; - font-size: 90%; - word-wrap: break-word; - overflow-wrap : break-word; -} - -div.sphinxsidebar ul { - list-style: none; -} - -div.sphinxsidebar ul ul, -div.sphinxsidebar ul.want-points { - margin-left: 20px; - list-style: square; -} - -div.sphinxsidebar ul ul { - margin-top: 0; - margin-bottom: 0; -} - -div.sphinxsidebar form { - margin-top: 10px; -} - -div.sphinxsidebar input { - border: 1px solid #98dbcc; - font-family: sans-serif; - font-size: 1em; -} - -div.sphinxsidebar #searchbox form.search { - overflow: hidden; -} - -div.sphinxsidebar #searchbox input[type="text"] { - float: left; - width: 80%; - padding: 0.25em; - box-sizing: border-box; -} - -div.sphinxsidebar #searchbox input[type="submit"] { - float: left; - width: 20%; - border-left: none; - padding: 0.25em; - box-sizing: border-box; -} - - -img { - border: 0; - max-width: 100%; -} - -/* -- search page ----------------------------------------------------------- */ - -ul.search { - margin: 10px 0 0 20px; - padding: 0; -} - -ul.search li { - padding: 5px 0 5px 20px; - background-image: url(file.png); - background-repeat: no-repeat; - background-position: 0 7px; -} - -ul.search li a { - font-weight: bold; -} - -ul.search li p.context { - color: #888; - margin: 2px 0 0 30px; - text-align: left; -} - -ul.keywordmatches li.goodmatch a { - font-weight: bold; -} - -/* -- index page ------------------------------------------------------------ */ - -table.contentstable { - width: 90%; - margin-left: auto; - margin-right: auto; -} - -table.contentstable p.biglink { - line-height: 150%; -} - -a.biglink { - font-size: 1.3em; -} - -span.linkdescr { - font-style: italic; - padding-top: 5px; - font-size: 90%; -} - -/* -- general index --------------------------------------------------------- */ - -table.indextable { - width: 100%; -} - -table.indextable td { - text-align: left; - vertical-align: top; -} - -table.indextable ul { - margin-top: 0; - margin-bottom: 0; - list-style-type: none; -} - -table.indextable > tbody > tr > td > ul { - padding-left: 0em; -} - -table.indextable tr.pcap { - height: 10px; -} - -table.indextable tr.cap { - margin-top: 10px; - background-color: #f2f2f2; -} - -img.toggler { - margin-right: 3px; - margin-top: 3px; - cursor: pointer; -} - -div.modindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -div.genindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -/* -- domain module index --------------------------------------------------- */ - -table.modindextable td { - padding: 2px; - border-collapse: collapse; -} - -/* -- general body styles --------------------------------------------------- */ - -div.body { - min-width: 360px; - max-width: 800px; -} - -div.body p, div.body dd, div.body li, div.body blockquote { - -moz-hyphens: auto; - -ms-hyphens: auto; - -webkit-hyphens: auto; - hyphens: auto; -} - -a.headerlink { - visibility: hidden; -} - -h1:hover > a.headerlink, -h2:hover > a.headerlink, -h3:hover > a.headerlink, -h4:hover > a.headerlink, -h5:hover > a.headerlink, -h6:hover > a.headerlink, -dt:hover > a.headerlink, -caption:hover > a.headerlink, -p.caption:hover > a.headerlink, -div.code-block-caption:hover > a.headerlink { - visibility: visible; -} - -div.body p.caption { - text-align: inherit; -} - -div.body td { - text-align: left; -} - -.first { - margin-top: 0 !important; -} - -p.rubric { - margin-top: 30px; - font-weight: bold; -} - -img.align-left, figure.align-left, .figure.align-left, object.align-left { - clear: left; - float: left; - margin-right: 1em; -} - -img.align-right, figure.align-right, .figure.align-right, object.align-right { - clear: right; - float: right; - margin-left: 1em; -} - -img.align-center, figure.align-center, .figure.align-center, object.align-center { - display: block; - margin-left: auto; - margin-right: auto; -} - -img.align-default, figure.align-default, .figure.align-default { - display: block; - margin-left: auto; - margin-right: auto; -} - -.align-left { - text-align: left; -} - -.align-center { - text-align: center; -} - -.align-default { - text-align: center; -} - -.align-right { - text-align: right; -} - -/* -- sidebars -------------------------------------------------------------- */ - -div.sidebar, -aside.sidebar { - margin: 0 0 0.5em 1em; - border: 1px solid #ddb; - padding: 7px; - background-color: #ffe; - width: 40%; - float: right; - clear: right; - overflow-x: auto; -} - -p.sidebar-title { - font-weight: bold; -} -nav.contents, -aside.topic, -div.admonition, div.topic, blockquote { - clear: left; -} - -/* -- topics ---------------------------------------------------------------- */ -nav.contents, -aside.topic, -div.topic { - border: 1px solid #ccc; - padding: 7px; - margin: 10px 0 10px 0; -} - -p.topic-title { - font-size: 1.1em; - font-weight: bold; - margin-top: 10px; -} - -/* -- admonitions ----------------------------------------------------------- */ - -div.admonition { - margin-top: 10px; - margin-bottom: 10px; - padding: 7px; -} - -div.admonition dt { - font-weight: bold; -} - -p.admonition-title { - margin: 0px 10px 5px 0px; - font-weight: bold; -} - -div.body p.centered { - text-align: center; - margin-top: 25px; -} - -/* -- content of sidebars/topics/admonitions -------------------------------- */ - -div.sidebar > :last-child, -aside.sidebar > :last-child, -nav.contents > :last-child, -aside.topic > :last-child, -div.topic > :last-child, -div.admonition > :last-child { - margin-bottom: 0; -} - -div.sidebar::after, -aside.sidebar::after, -nav.contents::after, -aside.topic::after, -div.topic::after, -div.admonition::after, -blockquote::after { - display: block; - content: ''; - clear: both; -} - -/* -- tables ---------------------------------------------------------------- */ - -table.docutils { - margin-top: 10px; - margin-bottom: 10px; - border: 0; - border-collapse: collapse; -} - -table.align-center { - margin-left: auto; - margin-right: auto; -} - -table.align-default { - margin-left: auto; - margin-right: auto; -} - -table caption span.caption-number { - font-style: italic; -} - -table caption span.caption-text { -} - -table.docutils td, table.docutils th { - padding: 1px 8px 1px 5px; - border-top: 0; - border-left: 0; - border-right: 0; - border-bottom: 1px solid #aaa; -} - -th { - text-align: left; - padding-right: 5px; -} - -table.citation { - border-left: solid 1px gray; - margin-left: 1px; -} - -table.citation td { - border-bottom: none; -} - -th > :first-child, -td > :first-child { - margin-top: 0px; -} - -th > :last-child, -td > :last-child { - margin-bottom: 0px; -} - -/* -- figures --------------------------------------------------------------- */ - -div.figure, figure { - margin: 0.5em; - padding: 0.5em; -} - -div.figure p.caption, figcaption { - padding: 0.3em; -} - -div.figure p.caption span.caption-number, -figcaption span.caption-number { - font-style: italic; -} - -div.figure p.caption span.caption-text, -figcaption span.caption-text { -} - -/* -- field list styles ----------------------------------------------------- */ - -table.field-list td, table.field-list th { - border: 0 !important; -} - -.field-list ul { - margin: 0; - padding-left: 1em; -} - -.field-list p { - margin: 0; -} - -.field-name { - -moz-hyphens: manual; - -ms-hyphens: manual; - -webkit-hyphens: manual; - hyphens: manual; -} - -/* -- hlist styles ---------------------------------------------------------- */ - -table.hlist { - margin: 1em 0; -} - -table.hlist td { - vertical-align: top; -} - -/* -- object description styles --------------------------------------------- */ - -.sig { - font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; -} - -.sig-name, code.descname { - background-color: transparent; - font-weight: bold; -} - -.sig-name { - font-size: 1.1em; -} - -code.descname { - font-size: 1.2em; -} - -.sig-prename, code.descclassname { - background-color: transparent; -} - -.optional { - font-size: 1.3em; -} - -.sig-paren { - font-size: larger; -} - -.sig-param.n { - font-style: italic; -} - -/* C++ specific styling */ - -.sig-inline.c-texpr, -.sig-inline.cpp-texpr { - font-family: unset; -} - -.sig.c .k, .sig.c .kt, -.sig.cpp .k, .sig.cpp .kt { - color: #0033B3; -} - -.sig.c .m, -.sig.cpp .m { - color: #1750EB; -} - -.sig.c .s, .sig.c .sc, -.sig.cpp .s, .sig.cpp .sc { - color: #067D17; -} - - -/* -- other body styles ----------------------------------------------------- */ - -ol.arabic { - list-style: decimal; -} - -ol.loweralpha { - list-style: lower-alpha; -} - -ol.upperalpha { - list-style: upper-alpha; -} - -ol.lowerroman { - list-style: lower-roman; -} - -ol.upperroman { - list-style: upper-roman; -} - -:not(li) > ol > li:first-child > :first-child, -:not(li) > ul > li:first-child > :first-child { - margin-top: 0px; -} - -:not(li) > ol > li:last-child > :last-child, -:not(li) > ul > li:last-child > :last-child { - margin-bottom: 0px; -} - -ol.simple ol p, -ol.simple ul p, -ul.simple ol p, -ul.simple ul p { - margin-top: 0; -} - -ol.simple > li:not(:first-child) > p, -ul.simple > li:not(:first-child) > p { - margin-top: 0; -} - -ol.simple p, -ul.simple p { - margin-bottom: 0; -} -aside.footnote > span, -div.citation > span { - float: left; -} -aside.footnote > span:last-of-type, -div.citation > span:last-of-type { - padding-right: 0.5em; -} -aside.footnote > p { - margin-left: 2em; -} -div.citation > p { - margin-left: 4em; -} -aside.footnote > p:last-of-type, -div.citation > p:last-of-type { - margin-bottom: 0em; -} -aside.footnote > p:last-of-type:after, -div.citation > p:last-of-type:after { - content: ""; - clear: both; -} - -dl.field-list { - display: grid; - grid-template-columns: fit-content(30%) auto; -} - -dl.field-list > dt { - font-weight: bold; - word-break: break-word; - padding-left: 0.5em; - padding-right: 5px; -} - -dl.field-list > dd { - padding-left: 0.5em; - margin-top: 0em; - margin-left: 0em; - margin-bottom: 0em; -} - -dl { - margin-bottom: 15px; -} - -dd > :first-child { - margin-top: 0px; -} - -dd ul, dd table { - margin-bottom: 10px; -} - -dd { - margin-top: 3px; - margin-bottom: 10px; - margin-left: 30px; -} - -dl > dd:last-child, -dl > dd:last-child > :last-child { - margin-bottom: 0; -} - -dt:target, span.highlighted { - background-color: #fbe54e; -} - -rect.highlighted { - fill: #fbe54e; -} - -dl.glossary dt { - font-weight: bold; - font-size: 1.1em; -} - -.versionmodified { - font-style: italic; -} - -.system-message { - background-color: #fda; - padding: 5px; - border: 3px solid red; -} - -.footnote:target { - background-color: #ffa; -} - -.line-block { - display: block; - margin-top: 1em; - margin-bottom: 1em; -} - -.line-block .line-block { - margin-top: 0; - margin-bottom: 0; - margin-left: 1.5em; -} - -.guilabel, .menuselection { - font-family: sans-serif; -} - -.accelerator { - text-decoration: underline; -} - -.classifier { - font-style: oblique; -} - -.classifier:before { - font-style: normal; - margin: 0 0.5em; - content: ":"; - display: inline-block; -} - -abbr, acronym { - border-bottom: dotted 1px; - cursor: help; -} - -/* -- code displays --------------------------------------------------------- */ - -pre { - overflow: auto; - overflow-y: hidden; /* fixes display issues on Chrome browsers */ -} - -pre, div[class*="highlight-"] { - clear: both; -} - -span.pre { - -moz-hyphens: none; - -ms-hyphens: none; - -webkit-hyphens: none; - hyphens: none; - white-space: nowrap; -} - -div[class*="highlight-"] { - margin: 1em 0; -} - -td.linenos pre { - border: 0; - background-color: transparent; - color: #aaa; -} - -table.highlighttable { - display: block; -} - -table.highlighttable tbody { - display: block; -} - -table.highlighttable tr { - display: flex; -} - -table.highlighttable td { - margin: 0; - padding: 0; -} - -table.highlighttable td.linenos { - padding-right: 0.5em; -} - -table.highlighttable td.code { - flex: 1; - overflow: hidden; -} - -.highlight .hll { - display: block; -} - -div.highlight pre, -table.highlighttable pre { - margin: 0; -} - -div.code-block-caption + div { - margin-top: 0; -} - -div.code-block-caption { - margin-top: 1em; - padding: 2px 5px; - font-size: small; -} - -div.code-block-caption code { - background-color: transparent; -} - -table.highlighttable td.linenos, -span.linenos, -div.highlight span.gp { /* gp: Generic.Prompt */ - user-select: none; - -webkit-user-select: text; /* Safari fallback only */ - -webkit-user-select: none; /* Chrome/Safari */ - -moz-user-select: none; /* Firefox */ - -ms-user-select: none; /* IE10+ */ -} - -div.code-block-caption span.caption-number { - padding: 0.1em 0.3em; - font-style: italic; -} - -div.code-block-caption span.caption-text { -} - -div.literal-block-wrapper { - margin: 1em 0; -} - -code.xref, a code { - background-color: transparent; - font-weight: bold; -} - -h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { - background-color: transparent; -} - -.viewcode-link { - float: right; -} - -.viewcode-back { - float: right; - font-family: sans-serif; -} - -div.viewcode-block:target { - margin: -1px -10px; - padding: 0 10px; -} - -/* -- math display ---------------------------------------------------------- */ - -img.math { - vertical-align: middle; -} - -div.body div.math p { - text-align: center; -} - -span.eqno { - float: right; -} - -span.eqno a.headerlink { - position: absolute; - z-index: 1; -} - -div.math:hover a.headerlink { - visibility: visible; -} - -/* -- printout stylesheet --------------------------------------------------- */ - -@media print { - div.document, - div.documentwrapper, - div.bodywrapper { - margin: 0 !important; - width: 100%; - } - - div.sphinxsidebar, - div.related, - div.footer, - #top-link { - display: none; - } -} \ No newline at end of file diff --git a/datafusion/_static/doctools.js b/datafusion/_static/doctools.js deleted file mode 100644 index c3db08d1c389..000000000000 --- a/datafusion/_static/doctools.js +++ /dev/null @@ -1,264 +0,0 @@ -/* - * doctools.js - * ~~~~~~~~~~~ - * - * Base JavaScript utilities for all Sphinx HTML documentation. - * - * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ -"use strict"; - -const _ready = (callback) => { - if (document.readyState !== "loading") { - callback(); - } else { - document.addEventListener("DOMContentLoaded", callback); - } -}; - -/** - * highlight a given string on a node by wrapping it in - * span elements with the given class name. - */ -const _highlight = (node, addItems, text, className) => { - if (node.nodeType === Node.TEXT_NODE) { - const val = node.nodeValue; - const parent = node.parentNode; - const pos = val.toLowerCase().indexOf(text); - if ( - pos >= 0 && - !parent.classList.contains(className) && - !parent.classList.contains("nohighlight") - ) { - let span; - - const closestNode = parent.closest("body, svg, foreignObject"); - const isInSVG = closestNode && closestNode.matches("svg"); - if (isInSVG) { - span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); - } else { - span = document.createElement("span"); - span.classList.add(className); - } - - span.appendChild(document.createTextNode(val.substr(pos, text.length))); - parent.insertBefore( - span, - parent.insertBefore( - document.createTextNode(val.substr(pos + text.length)), - node.nextSibling - ) - ); - node.nodeValue = val.substr(0, pos); - - if (isInSVG) { - const rect = document.createElementNS( - "http://www.w3.org/2000/svg", - "rect" - ); - const bbox = parent.getBBox(); - rect.x.baseVal.value = bbox.x; - rect.y.baseVal.value = bbox.y; - rect.width.baseVal.value = bbox.width; - rect.height.baseVal.value = bbox.height; - rect.setAttribute("class", className); - addItems.push({ parent: parent, target: rect }); - } - } - } else if (node.matches && !node.matches("button, select, textarea")) { - node.childNodes.forEach((el) => _highlight(el, addItems, text, className)); - } -}; -const _highlightText = (thisNode, text, className) => { - let addItems = []; - _highlight(thisNode, addItems, text, className); - addItems.forEach((obj) => - obj.parent.insertAdjacentElement("beforebegin", obj.target) - ); -}; - -/** - * Small JavaScript module for the documentation. - */ -const Documentation = { - init: () => { - Documentation.highlightSearchWords(); - Documentation.initDomainIndexTable(); - Documentation.initOnKeyListeners(); - }, - - /** - * i18n support - */ - TRANSLATIONS: {}, - PLURAL_EXPR: (n) => (n === 1 ? 0 : 1), - LOCALE: "unknown", - - // gettext and ngettext don't access this so that the functions - // can safely bound to a different name (_ = Documentation.gettext) - gettext: (string) => { - const translated = Documentation.TRANSLATIONS[string]; - switch (typeof translated) { - case "undefined": - return string; // no translation - case "string": - return translated; // translation exists - default: - return translated[0]; // (singular, plural) translation tuple exists - } - }, - - ngettext: (singular, plural, n) => { - const translated = Documentation.TRANSLATIONS[singular]; - if (typeof translated !== "undefined") - return translated[Documentation.PLURAL_EXPR(n)]; - return n === 1 ? singular : plural; - }, - - addTranslations: (catalog) => { - Object.assign(Documentation.TRANSLATIONS, catalog.messages); - Documentation.PLURAL_EXPR = new Function( - "n", - `return (${catalog.plural_expr})` - ); - Documentation.LOCALE = catalog.locale; - }, - - /** - * highlight the search words provided in the url in the text - */ - highlightSearchWords: () => { - const highlight = - new URLSearchParams(window.location.search).get("highlight") || ""; - const terms = highlight.toLowerCase().split(/\s+/).filter(x => x); - if (terms.length === 0) return; // nothing to do - - // There should never be more than one element matching "div.body" - const divBody = document.querySelectorAll("div.body"); - const body = divBody.length ? divBody[0] : document.querySelector("body"); - window.setTimeout(() => { - terms.forEach((term) => _highlightText(body, term, "highlighted")); - }, 10); - - const searchBox = document.getElementById("searchbox"); - if (searchBox === null) return; - searchBox.appendChild( - document - .createRange() - .createContextualFragment( - '

' + - '' + - Documentation.gettext("Hide Search Matches") + - "

" - ) - ); - }, - - /** - * helper function to hide the search marks again - */ - hideSearchWords: () => { - document - .querySelectorAll("#searchbox .highlight-link") - .forEach((el) => el.remove()); - document - .querySelectorAll("span.highlighted") - .forEach((el) => el.classList.remove("highlighted")); - const url = new URL(window.location); - url.searchParams.delete("highlight"); - window.history.replaceState({}, "", url); - }, - - /** - * helper function to focus on search bar - */ - focusSearchBar: () => { - document.querySelectorAll("input[name=q]")[0]?.focus(); - }, - - /** - * Initialise the domain index toggle buttons - */ - initDomainIndexTable: () => { - const toggler = (el) => { - const idNumber = el.id.substr(7); - const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`); - if (el.src.substr(-9) === "minus.png") { - el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`; - toggledRows.forEach((el) => (el.style.display = "none")); - } else { - el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`; - toggledRows.forEach((el) => (el.style.display = "")); - } - }; - - const togglerElements = document.querySelectorAll("img.toggler"); - togglerElements.forEach((el) => - el.addEventListener("click", (event) => toggler(event.currentTarget)) - ); - togglerElements.forEach((el) => (el.style.display = "")); - if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler); - }, - - initOnKeyListeners: () => { - // only install a listener if it is really needed - if ( - !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS && - !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS - ) - return; - - const blacklistedElements = new Set([ - "TEXTAREA", - "INPUT", - "SELECT", - "BUTTON", - ]); - document.addEventListener("keydown", (event) => { - if (blacklistedElements.has(document.activeElement.tagName)) return; // bail for input elements - if (event.altKey || event.ctrlKey || event.metaKey) return; // bail with special keys - - if (!event.shiftKey) { - switch (event.key) { - case "ArrowLeft": - if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; - - const prevLink = document.querySelector('link[rel="prev"]'); - if (prevLink && prevLink.href) { - window.location.href = prevLink.href; - event.preventDefault(); - } - break; - case "ArrowRight": - if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; - - const nextLink = document.querySelector('link[rel="next"]'); - if (nextLink && nextLink.href) { - window.location.href = nextLink.href; - event.preventDefault(); - } - break; - case "Escape": - if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; - Documentation.hideSearchWords(); - event.preventDefault(); - } - } - - // some keyboard layouts may need Shift to get / - switch (event.key) { - case "/": - if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; - Documentation.focusSearchBar(); - event.preventDefault(); - } - }); - }, -}; - -// quick alias for translations -const _ = Documentation.gettext; - -_ready(Documentation.init); diff --git a/datafusion/_static/documentation_options.js b/datafusion/_static/documentation_options.js deleted file mode 100644 index 902bb335898a..000000000000 --- a/datafusion/_static/documentation_options.js +++ /dev/null @@ -1,14 +0,0 @@ -var DOCUMENTATION_OPTIONS = { - URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), - VERSION: '', - LANGUAGE: 'en', - COLLAPSE_INDEX: false, - BUILDER: 'html', - FILE_SUFFIX: '.html', - LINK_SUFFIX: '.html', - HAS_SOURCE: true, - SOURCELINK_SUFFIX: '.txt', - NAVIGATION_WITH_KEYS: true, - SHOW_SEARCH_SUMMARY: true, - ENABLE_SEARCH_SHORTCUTS: true, -}; \ No newline at end of file diff --git a/datafusion/_static/file.png b/datafusion/_static/file.png deleted file mode 100644 index a858a410e4fa..000000000000 Binary files a/datafusion/_static/file.png and /dev/null differ diff --git a/datafusion/_static/images/DataFusion-Logo-Background-White.png b/datafusion/_static/images/DataFusion-Logo-Background-White.png deleted file mode 100644 index 023c2373fc49..000000000000 Binary files a/datafusion/_static/images/DataFusion-Logo-Background-White.png and /dev/null differ diff --git a/datafusion/_static/images/DataFusion-Logo-Background-White.svg b/datafusion/_static/images/DataFusion-Logo-Background-White.svg deleted file mode 100644 index b3bb47c5e07f..000000000000 --- a/datafusion/_static/images/DataFusion-Logo-Background-White.svg +++ /dev/null @@ -1 +0,0 @@ -DataFUSION-Logo-Dark \ No newline at end of file diff --git a/datafusion/_static/images/DataFusion-Logo-Dark.png b/datafusion/_static/images/DataFusion-Logo-Dark.png deleted file mode 100644 index cc60f12a0e4f..000000000000 Binary files a/datafusion/_static/images/DataFusion-Logo-Dark.png and /dev/null differ diff --git a/datafusion/_static/images/DataFusion-Logo-Dark.svg b/datafusion/_static/images/DataFusion-Logo-Dark.svg deleted file mode 100644 index e16f244430e6..000000000000 --- a/datafusion/_static/images/DataFusion-Logo-Dark.svg +++ /dev/null @@ -1 +0,0 @@ -DataFUSION-Logo-Dark \ No newline at end of file diff --git a/datafusion/_static/images/DataFusion-Logo-Light.png b/datafusion/_static/images/DataFusion-Logo-Light.png deleted file mode 100644 index 8992213b0e60..000000000000 Binary files a/datafusion/_static/images/DataFusion-Logo-Light.png and /dev/null differ diff --git a/datafusion/_static/images/DataFusion-Logo-Light.svg b/datafusion/_static/images/DataFusion-Logo-Light.svg deleted file mode 100644 index b3bef2193dde..000000000000 --- a/datafusion/_static/images/DataFusion-Logo-Light.svg +++ /dev/null @@ -1 +0,0 @@ -DataFUSION-Logo-Light \ No newline at end of file diff --git a/datafusion/_static/jquery-3.6.0.js b/datafusion/_static/jquery-3.6.0.js deleted file mode 100644 index fc6c299b73e7..000000000000 --- a/datafusion/_static/jquery-3.6.0.js +++ /dev/null @@ -1,10881 +0,0 @@ -/*! - * jQuery JavaScript Library v3.6.0 - * https://jquery.com/ - * - * Includes Sizzle.js - * https://sizzlejs.com/ - * - * Copyright OpenJS Foundation and other contributors - * Released under the MIT license - * https://jquery.org/license - * - * Date: 2021-03-02T17:08Z - */ -( function( global, factory ) { - - "use strict"; - - if ( typeof module === "object" && typeof module.exports === "object" ) { - - // For CommonJS and CommonJS-like environments where a proper `window` - // is present, execute the factory and get jQuery. - // For environments that do not have a `window` with a `document` - // (such as Node.js), expose a factory as module.exports. - // This accentuates the need for the creation of a real `window`. - // e.g. var jQuery = require("jquery")(window); - // See ticket #14549 for more info. - module.exports = global.document ? - factory( global, true ) : - function( w ) { - if ( !w.document ) { - throw new Error( "jQuery requires a window with a document" ); - } - return factory( w ); - }; - } else { - factory( global ); - } - -// Pass this if window is not defined yet -} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) { - -// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1 -// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode -// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common -// enough that all such attempts are guarded in a try block. -"use strict"; - -var arr = []; - -var getProto = Object.getPrototypeOf; - -var slice = arr.slice; - -var flat = arr.flat ? function( array ) { - return arr.flat.call( array ); -} : function( array ) { - return arr.concat.apply( [], array ); -}; - - -var push = arr.push; - -var indexOf = arr.indexOf; - -var class2type = {}; - -var toString = class2type.toString; - -var hasOwn = class2type.hasOwnProperty; - -var fnToString = hasOwn.toString; - -var ObjectFunctionString = fnToString.call( Object ); - -var support = {}; - -var isFunction = function isFunction( obj ) { - - // Support: Chrome <=57, Firefox <=52 - // In some browsers, typeof returns "function" for HTML elements - // (i.e., `typeof document.createElement( "object" ) === "function"`). - // We don't want to classify *any* DOM node as a function. - // Support: QtWeb <=3.8.5, WebKit <=534.34, wkhtmltopdf tool <=0.12.5 - // Plus for old WebKit, typeof returns "function" for HTML collections - // (e.g., `typeof document.getElementsByTagName("div") === "function"`). (gh-4756) - return typeof obj === "function" && typeof obj.nodeType !== "number" && - typeof obj.item !== "function"; - }; - - -var isWindow = function isWindow( obj ) { - return obj != null && obj === obj.window; - }; - - -var document = window.document; - - - - var preservedScriptAttributes = { - type: true, - src: true, - nonce: true, - noModule: true - }; - - function DOMEval( code, node, doc ) { - doc = doc || document; - - var i, val, - script = doc.createElement( "script" ); - - script.text = code; - if ( node ) { - for ( i in preservedScriptAttributes ) { - - // Support: Firefox 64+, Edge 18+ - // Some browsers don't support the "nonce" property on scripts. - // On the other hand, just using `getAttribute` is not enough as - // the `nonce` attribute is reset to an empty string whenever it - // becomes browsing-context connected. - // See https://github.com/whatwg/html/issues/2369 - // See https://html.spec.whatwg.org/#nonce-attributes - // The `node.getAttribute` check was added for the sake of - // `jQuery.globalEval` so that it can fake a nonce-containing node - // via an object. - val = node[ i ] || node.getAttribute && node.getAttribute( i ); - if ( val ) { - script.setAttribute( i, val ); - } - } - } - doc.head.appendChild( script ).parentNode.removeChild( script ); - } - - -function toType( obj ) { - if ( obj == null ) { - return obj + ""; - } - - // Support: Android <=2.3 only (functionish RegExp) - return typeof obj === "object" || typeof obj === "function" ? - class2type[ toString.call( obj ) ] || "object" : - typeof obj; -} -/* global Symbol */ -// Defining this global in .eslintrc.json would create a danger of using the global -// unguarded in another place, it seems safer to define global only for this module - - - -var - version = "3.6.0", - - // Define a local copy of jQuery - jQuery = function( selector, context ) { - - // The jQuery object is actually just the init constructor 'enhanced' - // Need init if jQuery is called (just allow error to be thrown if not included) - return new jQuery.fn.init( selector, context ); - }; - -jQuery.fn = jQuery.prototype = { - - // The current version of jQuery being used - jquery: version, - - constructor: jQuery, - - // The default length of a jQuery object is 0 - length: 0, - - toArray: function() { - return slice.call( this ); - }, - - // Get the Nth element in the matched element set OR - // Get the whole matched element set as a clean array - get: function( num ) { - - // Return all the elements in a clean array - if ( num == null ) { - return slice.call( this ); - } - - // Return just the one element from the set - return num < 0 ? this[ num + this.length ] : this[ num ]; - }, - - // Take an array of elements and push it onto the stack - // (returning the new matched element set) - pushStack: function( elems ) { - - // Build a new jQuery matched element set - var ret = jQuery.merge( this.constructor(), elems ); - - // Add the old object onto the stack (as a reference) - ret.prevObject = this; - - // Return the newly-formed element set - return ret; - }, - - // Execute a callback for every element in the matched set. - each: function( callback ) { - return jQuery.each( this, callback ); - }, - - map: function( callback ) { - return this.pushStack( jQuery.map( this, function( elem, i ) { - return callback.call( elem, i, elem ); - } ) ); - }, - - slice: function() { - return this.pushStack( slice.apply( this, arguments ) ); - }, - - first: function() { - return this.eq( 0 ); - }, - - last: function() { - return this.eq( -1 ); - }, - - even: function() { - return this.pushStack( jQuery.grep( this, function( _elem, i ) { - return ( i + 1 ) % 2; - } ) ); - }, - - odd: function() { - return this.pushStack( jQuery.grep( this, function( _elem, i ) { - return i % 2; - } ) ); - }, - - eq: function( i ) { - var len = this.length, - j = +i + ( i < 0 ? len : 0 ); - return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] ); - }, - - end: function() { - return this.prevObject || this.constructor(); - }, - - // For internal use only. - // Behaves like an Array's method, not like a jQuery method. - push: push, - sort: arr.sort, - splice: arr.splice -}; - -jQuery.extend = jQuery.fn.extend = function() { - var options, name, src, copy, copyIsArray, clone, - target = arguments[ 0 ] || {}, - i = 1, - length = arguments.length, - deep = false; - - // Handle a deep copy situation - if ( typeof target === "boolean" ) { - deep = target; - - // Skip the boolean and the target - target = arguments[ i ] || {}; - i++; - } - - // Handle case when target is a string or something (possible in deep copy) - if ( typeof target !== "object" && !isFunction( target ) ) { - target = {}; - } - - // Extend jQuery itself if only one argument is passed - if ( i === length ) { - target = this; - i--; - } - - for ( ; i < length; i++ ) { - - // Only deal with non-null/undefined values - if ( ( options = arguments[ i ] ) != null ) { - - // Extend the base object - for ( name in options ) { - copy = options[ name ]; - - // Prevent Object.prototype pollution - // Prevent never-ending loop - if ( name === "__proto__" || target === copy ) { - continue; - } - - // Recurse if we're merging plain objects or arrays - if ( deep && copy && ( jQuery.isPlainObject( copy ) || - ( copyIsArray = Array.isArray( copy ) ) ) ) { - src = target[ name ]; - - // Ensure proper type for the source value - if ( copyIsArray && !Array.isArray( src ) ) { - clone = []; - } else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) { - clone = {}; - } else { - clone = src; - } - copyIsArray = false; - - // Never move original objects, clone them - target[ name ] = jQuery.extend( deep, clone, copy ); - - // Don't bring in undefined values - } else if ( copy !== undefined ) { - target[ name ] = copy; - } - } - } - } - - // Return the modified object - return target; -}; - -jQuery.extend( { - - // Unique for each copy of jQuery on the page - expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), - - // Assume jQuery is ready without the ready module - isReady: true, - - error: function( msg ) { - throw new Error( msg ); - }, - - noop: function() {}, - - isPlainObject: function( obj ) { - var proto, Ctor; - - // Detect obvious negatives - // Use toString instead of jQuery.type to catch host objects - if ( !obj || toString.call( obj ) !== "[object Object]" ) { - return false; - } - - proto = getProto( obj ); - - // Objects with no prototype (e.g., `Object.create( null )`) are plain - if ( !proto ) { - return true; - } - - // Objects with prototype are plain iff they were constructed by a global Object function - Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor; - return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString; - }, - - isEmptyObject: function( obj ) { - var name; - - for ( name in obj ) { - return false; - } - return true; - }, - - // Evaluates a script in a provided context; falls back to the global one - // if not specified. - globalEval: function( code, options, doc ) { - DOMEval( code, { nonce: options && options.nonce }, doc ); - }, - - each: function( obj, callback ) { - var length, i = 0; - - if ( isArrayLike( obj ) ) { - length = obj.length; - for ( ; i < length; i++ ) { - if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { - break; - } - } - } else { - for ( i in obj ) { - if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { - break; - } - } - } - - return obj; - }, - - // results is for internal usage only - makeArray: function( arr, results ) { - var ret = results || []; - - if ( arr != null ) { - if ( isArrayLike( Object( arr ) ) ) { - jQuery.merge( ret, - typeof arr === "string" ? - [ arr ] : arr - ); - } else { - push.call( ret, arr ); - } - } - - return ret; - }, - - inArray: function( elem, arr, i ) { - return arr == null ? -1 : indexOf.call( arr, elem, i ); - }, - - // Support: Android <=4.0 only, PhantomJS 1 only - // push.apply(_, arraylike) throws on ancient WebKit - merge: function( first, second ) { - var len = +second.length, - j = 0, - i = first.length; - - for ( ; j < len; j++ ) { - first[ i++ ] = second[ j ]; - } - - first.length = i; - - return first; - }, - - grep: function( elems, callback, invert ) { - var callbackInverse, - matches = [], - i = 0, - length = elems.length, - callbackExpect = !invert; - - // Go through the array, only saving the items - // that pass the validator function - for ( ; i < length; i++ ) { - callbackInverse = !callback( elems[ i ], i ); - if ( callbackInverse !== callbackExpect ) { - matches.push( elems[ i ] ); - } - } - - return matches; - }, - - // arg is for internal usage only - map: function( elems, callback, arg ) { - var length, value, - i = 0, - ret = []; - - // Go through the array, translating each of the items to their new values - if ( isArrayLike( elems ) ) { - length = elems.length; - for ( ; i < length; i++ ) { - value = callback( elems[ i ], i, arg ); - - if ( value != null ) { - ret.push( value ); - } - } - - // Go through every key on the object, - } else { - for ( i in elems ) { - value = callback( elems[ i ], i, arg ); - - if ( value != null ) { - ret.push( value ); - } - } - } - - // Flatten any nested arrays - return flat( ret ); - }, - - // A global GUID counter for objects - guid: 1, - - // jQuery.support is not used in Core but other projects attach their - // properties to it so it needs to exist. - support: support -} ); - -if ( typeof Symbol === "function" ) { - jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ]; -} - -// Populate the class2type map -jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ), - function( _i, name ) { - class2type[ "[object " + name + "]" ] = name.toLowerCase(); - } ); - -function isArrayLike( obj ) { - - // Support: real iOS 8.2 only (not reproducible in simulator) - // `in` check used to prevent JIT error (gh-2145) - // hasOwn isn't used here due to false negatives - // regarding Nodelist length in IE - var length = !!obj && "length" in obj && obj.length, - type = toType( obj ); - - if ( isFunction( obj ) || isWindow( obj ) ) { - return false; - } - - return type === "array" || length === 0 || - typeof length === "number" && length > 0 && ( length - 1 ) in obj; -} -var Sizzle = -/*! - * Sizzle CSS Selector Engine v2.3.6 - * https://sizzlejs.com/ - * - * Copyright JS Foundation and other contributors - * Released under the MIT license - * https://js.foundation/ - * - * Date: 2021-02-16 - */ -( function( window ) { -var i, - support, - Expr, - getText, - isXML, - tokenize, - compile, - select, - outermostContext, - sortInput, - hasDuplicate, - - // Local document vars - setDocument, - document, - docElem, - documentIsHTML, - rbuggyQSA, - rbuggyMatches, - matches, - contains, - - // Instance-specific data - expando = "sizzle" + 1 * new Date(), - preferredDoc = window.document, - dirruns = 0, - done = 0, - classCache = createCache(), - tokenCache = createCache(), - compilerCache = createCache(), - nonnativeSelectorCache = createCache(), - sortOrder = function( a, b ) { - if ( a === b ) { - hasDuplicate = true; - } - return 0; - }, - - // Instance methods - hasOwn = ( {} ).hasOwnProperty, - arr = [], - pop = arr.pop, - pushNative = arr.push, - push = arr.push, - slice = arr.slice, - - // Use a stripped-down indexOf as it's faster than native - // https://jsperf.com/thor-indexof-vs-for/5 - indexOf = function( list, elem ) { - var i = 0, - len = list.length; - for ( ; i < len; i++ ) { - if ( list[ i ] === elem ) { - return i; - } - } - return -1; - }, - - booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" + - "ismap|loop|multiple|open|readonly|required|scoped", - - // Regular expressions - - // http://www.w3.org/TR/css3-selectors/#whitespace - whitespace = "[\\x20\\t\\r\\n\\f]", - - // https://www.w3.org/TR/css-syntax-3/#ident-token-diagram - identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace + - "?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+", - - // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors - attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace + - - // Operator (capture 2) - "*([*^$|!~]?=)" + whitespace + - - // "Attribute values must be CSS identifiers [capture 5] - // or strings [capture 3 or capture 4]" - "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + - whitespace + "*\\]", - - pseudos = ":(" + identifier + ")(?:\\((" + - - // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: - // 1. quoted (capture 3; capture 4 or capture 5) - "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + - - // 2. simple (capture 6) - "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + - - // 3. anything else (capture 2) - ".*" + - ")\\)|)", - - // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter - rwhitespace = new RegExp( whitespace + "+", "g" ), - rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + - whitespace + "+$", "g" ), - - rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), - rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + - "*" ), - rdescend = new RegExp( whitespace + "|>" ), - - rpseudo = new RegExp( pseudos ), - ridentifier = new RegExp( "^" + identifier + "$" ), - - matchExpr = { - "ID": new RegExp( "^#(" + identifier + ")" ), - "CLASS": new RegExp( "^\\.(" + identifier + ")" ), - "TAG": new RegExp( "^(" + identifier + "|[*])" ), - "ATTR": new RegExp( "^" + attributes ), - "PSEUDO": new RegExp( "^" + pseudos ), - "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + - whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + - whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), - "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), - - // For use in libraries implementing .is() - // We use this for POS matching in `select` - "needsContext": new RegExp( "^" + whitespace + - "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace + - "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) - }, - - rhtml = /HTML$/i, - rinputs = /^(?:input|select|textarea|button)$/i, - rheader = /^h\d$/i, - - rnative = /^[^{]+\{\s*\[native \w/, - - // Easily-parseable/retrievable ID or TAG or CLASS selectors - rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, - - rsibling = /[+~]/, - - // CSS escapes - // http://www.w3.org/TR/CSS21/syndata.html#escaped-characters - runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ), - funescape = function( escape, nonHex ) { - var high = "0x" + escape.slice( 1 ) - 0x10000; - - return nonHex ? - - // Strip the backslash prefix from a non-hex escape sequence - nonHex : - - // Replace a hexadecimal escape sequence with the encoded Unicode code point - // Support: IE <=11+ - // For values outside the Basic Multilingual Plane (BMP), manually construct a - // surrogate pair - high < 0 ? - String.fromCharCode( high + 0x10000 ) : - String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); - }, - - // CSS string/identifier serialization - // https://drafts.csswg.org/cssom/#common-serializing-idioms - rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, - fcssescape = function( ch, asCodePoint ) { - if ( asCodePoint ) { - - // U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER - if ( ch === "\0" ) { - return "\uFFFD"; - } - - // Control characters and (dependent upon position) numbers get escaped as code points - return ch.slice( 0, -1 ) + "\\" + - ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " "; - } - - // Other potentially-special ASCII characters get backslash-escaped - return "\\" + ch; - }, - - // Used for iframes - // See setDocument() - // Removing the function wrapper causes a "Permission Denied" - // error in IE - unloadHandler = function() { - setDocument(); - }, - - inDisabledFieldset = addCombinator( - function( elem ) { - return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset"; - }, - { dir: "parentNode", next: "legend" } - ); - -// Optimize for push.apply( _, NodeList ) -try { - push.apply( - ( arr = slice.call( preferredDoc.childNodes ) ), - preferredDoc.childNodes - ); - - // Support: Android<4.0 - // Detect silently failing push.apply - // eslint-disable-next-line no-unused-expressions - arr[ preferredDoc.childNodes.length ].nodeType; -} catch ( e ) { - push = { apply: arr.length ? - - // Leverage slice if possible - function( target, els ) { - pushNative.apply( target, slice.call( els ) ); - } : - - // Support: IE<9 - // Otherwise append directly - function( target, els ) { - var j = target.length, - i = 0; - - // Can't trust NodeList.length - while ( ( target[ j++ ] = els[ i++ ] ) ) {} - target.length = j - 1; - } - }; -} - -function Sizzle( selector, context, results, seed ) { - var m, i, elem, nid, match, groups, newSelector, - newContext = context && context.ownerDocument, - - // nodeType defaults to 9, since context defaults to document - nodeType = context ? context.nodeType : 9; - - results = results || []; - - // Return early from calls with invalid selector or context - if ( typeof selector !== "string" || !selector || - nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) { - - return results; - } - - // Try to shortcut find operations (as opposed to filters) in HTML documents - if ( !seed ) { - setDocument( context ); - context = context || document; - - if ( documentIsHTML ) { - - // If the selector is sufficiently simple, try using a "get*By*" DOM method - // (excepting DocumentFragment context, where the methods don't exist) - if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) { - - // ID selector - if ( ( m = match[ 1 ] ) ) { - - // Document context - if ( nodeType === 9 ) { - if ( ( elem = context.getElementById( m ) ) ) { - - // Support: IE, Opera, Webkit - // TODO: identify versions - // getElementById can match elements by name instead of ID - if ( elem.id === m ) { - results.push( elem ); - return results; - } - } else { - return results; - } - - // Element context - } else { - - // Support: IE, Opera, Webkit - // TODO: identify versions - // getElementById can match elements by name instead of ID - if ( newContext && ( elem = newContext.getElementById( m ) ) && - contains( context, elem ) && - elem.id === m ) { - - results.push( elem ); - return results; - } - } - - // Type selector - } else if ( match[ 2 ] ) { - push.apply( results, context.getElementsByTagName( selector ) ); - return results; - - // Class selector - } else if ( ( m = match[ 3 ] ) && support.getElementsByClassName && - context.getElementsByClassName ) { - - push.apply( results, context.getElementsByClassName( m ) ); - return results; - } - } - - // Take advantage of querySelectorAll - if ( support.qsa && - !nonnativeSelectorCache[ selector + " " ] && - ( !rbuggyQSA || !rbuggyQSA.test( selector ) ) && - - // Support: IE 8 only - // Exclude object elements - ( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) { - - newSelector = selector; - newContext = context; - - // qSA considers elements outside a scoping root when evaluating child or - // descendant combinators, which is not what we want. - // In such cases, we work around the behavior by prefixing every selector in the - // list with an ID selector referencing the scope context. - // The technique has to be used as well when a leading combinator is used - // as such selectors are not recognized by querySelectorAll. - // Thanks to Andrew Dupont for this technique. - if ( nodeType === 1 && - ( rdescend.test( selector ) || rcombinators.test( selector ) ) ) { - - // Expand context for sibling selectors - newContext = rsibling.test( selector ) && testContext( context.parentNode ) || - context; - - // We can use :scope instead of the ID hack if the browser - // supports it & if we're not changing the context. - if ( newContext !== context || !support.scope ) { - - // Capture the context ID, setting it first if necessary - if ( ( nid = context.getAttribute( "id" ) ) ) { - nid = nid.replace( rcssescape, fcssescape ); - } else { - context.setAttribute( "id", ( nid = expando ) ); - } - } - - // Prefix every selector in the list - groups = tokenize( selector ); - i = groups.length; - while ( i-- ) { - groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " + - toSelector( groups[ i ] ); - } - newSelector = groups.join( "," ); - } - - try { - push.apply( results, - newContext.querySelectorAll( newSelector ) - ); - return results; - } catch ( qsaError ) { - nonnativeSelectorCache( selector, true ); - } finally { - if ( nid === expando ) { - context.removeAttribute( "id" ); - } - } - } - } - } - - // All others - return select( selector.replace( rtrim, "$1" ), context, results, seed ); -} - -/** - * Create key-value caches of limited size - * @returns {function(string, object)} Returns the Object data after storing it on itself with - * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) - * deleting the oldest entry - */ -function createCache() { - var keys = []; - - function cache( key, value ) { - - // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) - if ( keys.push( key + " " ) > Expr.cacheLength ) { - - // Only keep the most recent entries - delete cache[ keys.shift() ]; - } - return ( cache[ key + " " ] = value ); - } - return cache; -} - -/** - * Mark a function for special use by Sizzle - * @param {Function} fn The function to mark - */ -function markFunction( fn ) { - fn[ expando ] = true; - return fn; -} - -/** - * Support testing using an element - * @param {Function} fn Passed the created element and returns a boolean result - */ -function assert( fn ) { - var el = document.createElement( "fieldset" ); - - try { - return !!fn( el ); - } catch ( e ) { - return false; - } finally { - - // Remove from its parent by default - if ( el.parentNode ) { - el.parentNode.removeChild( el ); - } - - // release memory in IE - el = null; - } -} - -/** - * Adds the same handler for all of the specified attrs - * @param {String} attrs Pipe-separated list of attributes - * @param {Function} handler The method that will be applied - */ -function addHandle( attrs, handler ) { - var arr = attrs.split( "|" ), - i = arr.length; - - while ( i-- ) { - Expr.attrHandle[ arr[ i ] ] = handler; - } -} - -/** - * Checks document order of two siblings - * @param {Element} a - * @param {Element} b - * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b - */ -function siblingCheck( a, b ) { - var cur = b && a, - diff = cur && a.nodeType === 1 && b.nodeType === 1 && - a.sourceIndex - b.sourceIndex; - - // Use IE sourceIndex if available on both nodes - if ( diff ) { - return diff; - } - - // Check if b follows a - if ( cur ) { - while ( ( cur = cur.nextSibling ) ) { - if ( cur === b ) { - return -1; - } - } - } - - return a ? 1 : -1; -} - -/** - * Returns a function to use in pseudos for input types - * @param {String} type - */ -function createInputPseudo( type ) { - return function( elem ) { - var name = elem.nodeName.toLowerCase(); - return name === "input" && elem.type === type; - }; -} - -/** - * Returns a function to use in pseudos for buttons - * @param {String} type - */ -function createButtonPseudo( type ) { - return function( elem ) { - var name = elem.nodeName.toLowerCase(); - return ( name === "input" || name === "button" ) && elem.type === type; - }; -} - -/** - * Returns a function to use in pseudos for :enabled/:disabled - * @param {Boolean} disabled true for :disabled; false for :enabled - */ -function createDisabledPseudo( disabled ) { - - // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable - return function( elem ) { - - // Only certain elements can match :enabled or :disabled - // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled - // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled - if ( "form" in elem ) { - - // Check for inherited disabledness on relevant non-disabled elements: - // * listed form-associated elements in a disabled fieldset - // https://html.spec.whatwg.org/multipage/forms.html#category-listed - // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled - // * option elements in a disabled optgroup - // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled - // All such elements have a "form" property. - if ( elem.parentNode && elem.disabled === false ) { - - // Option elements defer to a parent optgroup if present - if ( "label" in elem ) { - if ( "label" in elem.parentNode ) { - return elem.parentNode.disabled === disabled; - } else { - return elem.disabled === disabled; - } - } - - // Support: IE 6 - 11 - // Use the isDisabled shortcut property to check for disabled fieldset ancestors - return elem.isDisabled === disabled || - - // Where there is no isDisabled, check manually - /* jshint -W018 */ - elem.isDisabled !== !disabled && - inDisabledFieldset( elem ) === disabled; - } - - return elem.disabled === disabled; - - // Try to winnow out elements that can't be disabled before trusting the disabled property. - // Some victims get caught in our net (label, legend, menu, track), but it shouldn't - // even exist on them, let alone have a boolean value. - } else if ( "label" in elem ) { - return elem.disabled === disabled; - } - - // Remaining elements are neither :enabled nor :disabled - return false; - }; -} - -/** - * Returns a function to use in pseudos for positionals - * @param {Function} fn - */ -function createPositionalPseudo( fn ) { - return markFunction( function( argument ) { - argument = +argument; - return markFunction( function( seed, matches ) { - var j, - matchIndexes = fn( [], seed.length, argument ), - i = matchIndexes.length; - - // Match elements found at the specified indexes - while ( i-- ) { - if ( seed[ ( j = matchIndexes[ i ] ) ] ) { - seed[ j ] = !( matches[ j ] = seed[ j ] ); - } - } - } ); - } ); -} - -/** - * Checks a node for validity as a Sizzle context - * @param {Element|Object=} context - * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value - */ -function testContext( context ) { - return context && typeof context.getElementsByTagName !== "undefined" && context; -} - -// Expose support vars for convenience -support = Sizzle.support = {}; - -/** - * Detects XML nodes - * @param {Element|Object} elem An element or a document - * @returns {Boolean} True iff elem is a non-HTML XML node - */ -isXML = Sizzle.isXML = function( elem ) { - var namespace = elem && elem.namespaceURI, - docElem = elem && ( elem.ownerDocument || elem ).documentElement; - - // Support: IE <=8 - // Assume HTML when documentElement doesn't yet exist, such as inside loading iframes - // https://bugs.jquery.com/ticket/4833 - return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" ); -}; - -/** - * Sets document-related variables once based on the current document - * @param {Element|Object} [doc] An element or document object to use to set the document - * @returns {Object} Returns the current document - */ -setDocument = Sizzle.setDocument = function( node ) { - var hasCompare, subWindow, - doc = node ? node.ownerDocument || node : preferredDoc; - - // Return early if doc is invalid or already selected - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) { - return document; - } - - // Update global variables - document = doc; - docElem = document.documentElement; - documentIsHTML = !isXML( document ); - - // Support: IE 9 - 11+, Edge 12 - 18+ - // Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936) - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( preferredDoc != document && - ( subWindow = document.defaultView ) && subWindow.top !== subWindow ) { - - // Support: IE 11, Edge - if ( subWindow.addEventListener ) { - subWindow.addEventListener( "unload", unloadHandler, false ); - - // Support: IE 9 - 10 only - } else if ( subWindow.attachEvent ) { - subWindow.attachEvent( "onunload", unloadHandler ); - } - } - - // Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only, - // Safari 4 - 5 only, Opera <=11.6 - 12.x only - // IE/Edge & older browsers don't support the :scope pseudo-class. - // Support: Safari 6.0 only - // Safari 6.0 supports :scope but it's an alias of :root there. - support.scope = assert( function( el ) { - docElem.appendChild( el ).appendChild( document.createElement( "div" ) ); - return typeof el.querySelectorAll !== "undefined" && - !el.querySelectorAll( ":scope fieldset div" ).length; - } ); - - /* Attributes - ---------------------------------------------------------------------- */ - - // Support: IE<8 - // Verify that getAttribute really returns attributes and not properties - // (excepting IE8 booleans) - support.attributes = assert( function( el ) { - el.className = "i"; - return !el.getAttribute( "className" ); - } ); - - /* getElement(s)By* - ---------------------------------------------------------------------- */ - - // Check if getElementsByTagName("*") returns only elements - support.getElementsByTagName = assert( function( el ) { - el.appendChild( document.createComment( "" ) ); - return !el.getElementsByTagName( "*" ).length; - } ); - - // Support: IE<9 - support.getElementsByClassName = rnative.test( document.getElementsByClassName ); - - // Support: IE<10 - // Check if getElementById returns elements by name - // The broken getElementById methods don't pick up programmatically-set names, - // so use a roundabout getElementsByName test - support.getById = assert( function( el ) { - docElem.appendChild( el ).id = expando; - return !document.getElementsByName || !document.getElementsByName( expando ).length; - } ); - - // ID filter and find - if ( support.getById ) { - Expr.filter[ "ID" ] = function( id ) { - var attrId = id.replace( runescape, funescape ); - return function( elem ) { - return elem.getAttribute( "id" ) === attrId; - }; - }; - Expr.find[ "ID" ] = function( id, context ) { - if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { - var elem = context.getElementById( id ); - return elem ? [ elem ] : []; - } - }; - } else { - Expr.filter[ "ID" ] = function( id ) { - var attrId = id.replace( runescape, funescape ); - return function( elem ) { - var node = typeof elem.getAttributeNode !== "undefined" && - elem.getAttributeNode( "id" ); - return node && node.value === attrId; - }; - }; - - // Support: IE 6 - 7 only - // getElementById is not reliable as a find shortcut - Expr.find[ "ID" ] = function( id, context ) { - if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { - var node, i, elems, - elem = context.getElementById( id ); - - if ( elem ) { - - // Verify the id attribute - node = elem.getAttributeNode( "id" ); - if ( node && node.value === id ) { - return [ elem ]; - } - - // Fall back on getElementsByName - elems = context.getElementsByName( id ); - i = 0; - while ( ( elem = elems[ i++ ] ) ) { - node = elem.getAttributeNode( "id" ); - if ( node && node.value === id ) { - return [ elem ]; - } - } - } - - return []; - } - }; - } - - // Tag - Expr.find[ "TAG" ] = support.getElementsByTagName ? - function( tag, context ) { - if ( typeof context.getElementsByTagName !== "undefined" ) { - return context.getElementsByTagName( tag ); - - // DocumentFragment nodes don't have gEBTN - } else if ( support.qsa ) { - return context.querySelectorAll( tag ); - } - } : - - function( tag, context ) { - var elem, - tmp = [], - i = 0, - - // By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too - results = context.getElementsByTagName( tag ); - - // Filter out possible comments - if ( tag === "*" ) { - while ( ( elem = results[ i++ ] ) ) { - if ( elem.nodeType === 1 ) { - tmp.push( elem ); - } - } - - return tmp; - } - return results; - }; - - // Class - Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) { - if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) { - return context.getElementsByClassName( className ); - } - }; - - /* QSA/matchesSelector - ---------------------------------------------------------------------- */ - - // QSA and matchesSelector support - - // matchesSelector(:active) reports false when true (IE9/Opera 11.5) - rbuggyMatches = []; - - // qSa(:focus) reports false when true (Chrome 21) - // We allow this because of a bug in IE8/9 that throws an error - // whenever `document.activeElement` is accessed on an iframe - // So, we allow :focus to pass through QSA all the time to avoid the IE error - // See https://bugs.jquery.com/ticket/13378 - rbuggyQSA = []; - - if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) { - - // Build QSA regex - // Regex strategy adopted from Diego Perini - assert( function( el ) { - - var input; - - // Select is set to empty string on purpose - // This is to test IE's treatment of not explicitly - // setting a boolean content attribute, - // since its presence should be enough - // https://bugs.jquery.com/ticket/12359 - docElem.appendChild( el ).innerHTML = "" + - ""; - - // Support: IE8, Opera 11-12.16 - // Nothing should be selected when empty strings follow ^= or $= or *= - // The test attribute must be unknown in Opera but "safe" for WinRT - // https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section - if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) { - rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); - } - - // Support: IE8 - // Boolean attributes and "value" are not treated correctly - if ( !el.querySelectorAll( "[selected]" ).length ) { - rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); - } - - // Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+ - if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) { - rbuggyQSA.push( "~=" ); - } - - // Support: IE 11+, Edge 15 - 18+ - // IE 11/Edge don't find elements on a `[name='']` query in some cases. - // Adding a temporary attribute to the document before the selection works - // around the issue. - // Interestingly, IE 10 & older don't seem to have the issue. - input = document.createElement( "input" ); - input.setAttribute( "name", "" ); - el.appendChild( input ); - if ( !el.querySelectorAll( "[name='']" ).length ) { - rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" + - whitespace + "*(?:''|\"\")" ); - } - - // Webkit/Opera - :checked should return selected option elements - // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked - // IE8 throws error here and will not see later tests - if ( !el.querySelectorAll( ":checked" ).length ) { - rbuggyQSA.push( ":checked" ); - } - - // Support: Safari 8+, iOS 8+ - // https://bugs.webkit.org/show_bug.cgi?id=136851 - // In-page `selector#id sibling-combinator selector` fails - if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) { - rbuggyQSA.push( ".#.+[+~]" ); - } - - // Support: Firefox <=3.6 - 5 only - // Old Firefox doesn't throw on a badly-escaped identifier. - el.querySelectorAll( "\\\f" ); - rbuggyQSA.push( "[\\r\\n\\f]" ); - } ); - - assert( function( el ) { - el.innerHTML = "" + - ""; - - // Support: Windows 8 Native Apps - // The type and name attributes are restricted during .innerHTML assignment - var input = document.createElement( "input" ); - input.setAttribute( "type", "hidden" ); - el.appendChild( input ).setAttribute( "name", "D" ); - - // Support: IE8 - // Enforce case-sensitivity of name attribute - if ( el.querySelectorAll( "[name=d]" ).length ) { - rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); - } - - // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) - // IE8 throws error here and will not see later tests - if ( el.querySelectorAll( ":enabled" ).length !== 2 ) { - rbuggyQSA.push( ":enabled", ":disabled" ); - } - - // Support: IE9-11+ - // IE's :disabled selector does not pick up the children of disabled fieldsets - docElem.appendChild( el ).disabled = true; - if ( el.querySelectorAll( ":disabled" ).length !== 2 ) { - rbuggyQSA.push( ":enabled", ":disabled" ); - } - - // Support: Opera 10 - 11 only - // Opera 10-11 does not throw on post-comma invalid pseudos - el.querySelectorAll( "*,:x" ); - rbuggyQSA.push( ",.*:" ); - } ); - } - - if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches || - docElem.webkitMatchesSelector || - docElem.mozMatchesSelector || - docElem.oMatchesSelector || - docElem.msMatchesSelector ) ) ) ) { - - assert( function( el ) { - - // Check to see if it's possible to do matchesSelector - // on a disconnected node (IE 9) - support.disconnectedMatch = matches.call( el, "*" ); - - // This should fail with an exception - // Gecko does not error, returns false instead - matches.call( el, "[s!='']:x" ); - rbuggyMatches.push( "!=", pseudos ); - } ); - } - - rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) ); - rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) ); - - /* Contains - ---------------------------------------------------------------------- */ - hasCompare = rnative.test( docElem.compareDocumentPosition ); - - // Element contains another - // Purposefully self-exclusive - // As in, an element does not contain itself - contains = hasCompare || rnative.test( docElem.contains ) ? - function( a, b ) { - var adown = a.nodeType === 9 ? a.documentElement : a, - bup = b && b.parentNode; - return a === bup || !!( bup && bup.nodeType === 1 && ( - adown.contains ? - adown.contains( bup ) : - a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 - ) ); - } : - function( a, b ) { - if ( b ) { - while ( ( b = b.parentNode ) ) { - if ( b === a ) { - return true; - } - } - } - return false; - }; - - /* Sorting - ---------------------------------------------------------------------- */ - - // Document order sorting - sortOrder = hasCompare ? - function( a, b ) { - - // Flag for duplicate removal - if ( a === b ) { - hasDuplicate = true; - return 0; - } - - // Sort on method existence if only one input has compareDocumentPosition - var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; - if ( compare ) { - return compare; - } - - // Calculate position if both inputs belong to the same document - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ? - a.compareDocumentPosition( b ) : - - // Otherwise we know they are disconnected - 1; - - // Disconnected nodes - if ( compare & 1 || - ( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) { - - // Choose the first element that is related to our preferred document - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( a == document || a.ownerDocument == preferredDoc && - contains( preferredDoc, a ) ) { - return -1; - } - - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( b == document || b.ownerDocument == preferredDoc && - contains( preferredDoc, b ) ) { - return 1; - } - - // Maintain original order - return sortInput ? - ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : - 0; - } - - return compare & 4 ? -1 : 1; - } : - function( a, b ) { - - // Exit early if the nodes are identical - if ( a === b ) { - hasDuplicate = true; - return 0; - } - - var cur, - i = 0, - aup = a.parentNode, - bup = b.parentNode, - ap = [ a ], - bp = [ b ]; - - // Parentless nodes are either documents or disconnected - if ( !aup || !bup ) { - - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - /* eslint-disable eqeqeq */ - return a == document ? -1 : - b == document ? 1 : - /* eslint-enable eqeqeq */ - aup ? -1 : - bup ? 1 : - sortInput ? - ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : - 0; - - // If the nodes are siblings, we can do a quick check - } else if ( aup === bup ) { - return siblingCheck( a, b ); - } - - // Otherwise we need full lists of their ancestors for comparison - cur = a; - while ( ( cur = cur.parentNode ) ) { - ap.unshift( cur ); - } - cur = b; - while ( ( cur = cur.parentNode ) ) { - bp.unshift( cur ); - } - - // Walk down the tree looking for a discrepancy - while ( ap[ i ] === bp[ i ] ) { - i++; - } - - return i ? - - // Do a sibling check if the nodes have a common ancestor - siblingCheck( ap[ i ], bp[ i ] ) : - - // Otherwise nodes in our document sort first - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - /* eslint-disable eqeqeq */ - ap[ i ] == preferredDoc ? -1 : - bp[ i ] == preferredDoc ? 1 : - /* eslint-enable eqeqeq */ - 0; - }; - - return document; -}; - -Sizzle.matches = function( expr, elements ) { - return Sizzle( expr, null, null, elements ); -}; - -Sizzle.matchesSelector = function( elem, expr ) { - setDocument( elem ); - - if ( support.matchesSelector && documentIsHTML && - !nonnativeSelectorCache[ expr + " " ] && - ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && - ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { - - try { - var ret = matches.call( elem, expr ); - - // IE 9's matchesSelector returns false on disconnected nodes - if ( ret || support.disconnectedMatch || - - // As well, disconnected nodes are said to be in a document - // fragment in IE 9 - elem.document && elem.document.nodeType !== 11 ) { - return ret; - } - } catch ( e ) { - nonnativeSelectorCache( expr, true ); - } - } - - return Sizzle( expr, document, null, [ elem ] ).length > 0; -}; - -Sizzle.contains = function( context, elem ) { - - // Set document vars if needed - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( ( context.ownerDocument || context ) != document ) { - setDocument( context ); - } - return contains( context, elem ); -}; - -Sizzle.attr = function( elem, name ) { - - // Set document vars if needed - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( ( elem.ownerDocument || elem ) != document ) { - setDocument( elem ); - } - - var fn = Expr.attrHandle[ name.toLowerCase() ], - - // Don't get fooled by Object.prototype properties (jQuery #13807) - val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? - fn( elem, name, !documentIsHTML ) : - undefined; - - return val !== undefined ? - val : - support.attributes || !documentIsHTML ? - elem.getAttribute( name ) : - ( val = elem.getAttributeNode( name ) ) && val.specified ? - val.value : - null; -}; - -Sizzle.escape = function( sel ) { - return ( sel + "" ).replace( rcssescape, fcssescape ); -}; - -Sizzle.error = function( msg ) { - throw new Error( "Syntax error, unrecognized expression: " + msg ); -}; - -/** - * Document sorting and removing duplicates - * @param {ArrayLike} results - */ -Sizzle.uniqueSort = function( results ) { - var elem, - duplicates = [], - j = 0, - i = 0; - - // Unless we *know* we can detect duplicates, assume their presence - hasDuplicate = !support.detectDuplicates; - sortInput = !support.sortStable && results.slice( 0 ); - results.sort( sortOrder ); - - if ( hasDuplicate ) { - while ( ( elem = results[ i++ ] ) ) { - if ( elem === results[ i ] ) { - j = duplicates.push( i ); - } - } - while ( j-- ) { - results.splice( duplicates[ j ], 1 ); - } - } - - // Clear input after sorting to release objects - // See https://github.com/jquery/sizzle/pull/225 - sortInput = null; - - return results; -}; - -/** - * Utility function for retrieving the text value of an array of DOM nodes - * @param {Array|Element} elem - */ -getText = Sizzle.getText = function( elem ) { - var node, - ret = "", - i = 0, - nodeType = elem.nodeType; - - if ( !nodeType ) { - - // If no nodeType, this is expected to be an array - while ( ( node = elem[ i++ ] ) ) { - - // Do not traverse comment nodes - ret += getText( node ); - } - } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { - - // Use textContent for elements - // innerText usage removed for consistency of new lines (jQuery #11153) - if ( typeof elem.textContent === "string" ) { - return elem.textContent; - } else { - - // Traverse its children - for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { - ret += getText( elem ); - } - } - } else if ( nodeType === 3 || nodeType === 4 ) { - return elem.nodeValue; - } - - // Do not include comment or processing instruction nodes - - return ret; -}; - -Expr = Sizzle.selectors = { - - // Can be adjusted by the user - cacheLength: 50, - - createPseudo: markFunction, - - match: matchExpr, - - attrHandle: {}, - - find: {}, - - relative: { - ">": { dir: "parentNode", first: true }, - " ": { dir: "parentNode" }, - "+": { dir: "previousSibling", first: true }, - "~": { dir: "previousSibling" } - }, - - preFilter: { - "ATTR": function( match ) { - match[ 1 ] = match[ 1 ].replace( runescape, funescape ); - - // Move the given value to match[3] whether quoted or unquoted - match[ 3 ] = ( match[ 3 ] || match[ 4 ] || - match[ 5 ] || "" ).replace( runescape, funescape ); - - if ( match[ 2 ] === "~=" ) { - match[ 3 ] = " " + match[ 3 ] + " "; - } - - return match.slice( 0, 4 ); - }, - - "CHILD": function( match ) { - - /* matches from matchExpr["CHILD"] - 1 type (only|nth|...) - 2 what (child|of-type) - 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) - 4 xn-component of xn+y argument ([+-]?\d*n|) - 5 sign of xn-component - 6 x of xn-component - 7 sign of y-component - 8 y of y-component - */ - match[ 1 ] = match[ 1 ].toLowerCase(); - - if ( match[ 1 ].slice( 0, 3 ) === "nth" ) { - - // nth-* requires argument - if ( !match[ 3 ] ) { - Sizzle.error( match[ 0 ] ); - } - - // numeric x and y parameters for Expr.filter.CHILD - // remember that false/true cast respectively to 0/1 - match[ 4 ] = +( match[ 4 ] ? - match[ 5 ] + ( match[ 6 ] || 1 ) : - 2 * ( match[ 3 ] === "even" || match[ 3 ] === "odd" ) ); - match[ 5 ] = +( ( match[ 7 ] + match[ 8 ] ) || match[ 3 ] === "odd" ); - - // other types prohibit arguments - } else if ( match[ 3 ] ) { - Sizzle.error( match[ 0 ] ); - } - - return match; - }, - - "PSEUDO": function( match ) { - var excess, - unquoted = !match[ 6 ] && match[ 2 ]; - - if ( matchExpr[ "CHILD" ].test( match[ 0 ] ) ) { - return null; - } - - // Accept quoted arguments as-is - if ( match[ 3 ] ) { - match[ 2 ] = match[ 4 ] || match[ 5 ] || ""; - - // Strip excess characters from unquoted arguments - } else if ( unquoted && rpseudo.test( unquoted ) && - - // Get excess from tokenize (recursively) - ( excess = tokenize( unquoted, true ) ) && - - // advance to the next closing parenthesis - ( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) { - - // excess is a negative index - match[ 0 ] = match[ 0 ].slice( 0, excess ); - match[ 2 ] = unquoted.slice( 0, excess ); - } - - // Return only captures needed by the pseudo filter method (type and argument) - return match.slice( 0, 3 ); - } - }, - - filter: { - - "TAG": function( nodeNameSelector ) { - var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); - return nodeNameSelector === "*" ? - function() { - return true; - } : - function( elem ) { - return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; - }; - }, - - "CLASS": function( className ) { - var pattern = classCache[ className + " " ]; - - return pattern || - ( pattern = new RegExp( "(^|" + whitespace + - ")" + className + "(" + whitespace + "|$)" ) ) && classCache( - className, function( elem ) { - return pattern.test( - typeof elem.className === "string" && elem.className || - typeof elem.getAttribute !== "undefined" && - elem.getAttribute( "class" ) || - "" - ); - } ); - }, - - "ATTR": function( name, operator, check ) { - return function( elem ) { - var result = Sizzle.attr( elem, name ); - - if ( result == null ) { - return operator === "!="; - } - if ( !operator ) { - return true; - } - - result += ""; - - /* eslint-disable max-len */ - - return operator === "=" ? result === check : - operator === "!=" ? result !== check : - operator === "^=" ? check && result.indexOf( check ) === 0 : - operator === "*=" ? check && result.indexOf( check ) > -1 : - operator === "$=" ? check && result.slice( -check.length ) === check : - operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 : - operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : - false; - /* eslint-enable max-len */ - - }; - }, - - "CHILD": function( type, what, _argument, first, last ) { - var simple = type.slice( 0, 3 ) !== "nth", - forward = type.slice( -4 ) !== "last", - ofType = what === "of-type"; - - return first === 1 && last === 0 ? - - // Shortcut for :nth-*(n) - function( elem ) { - return !!elem.parentNode; - } : - - function( elem, _context, xml ) { - var cache, uniqueCache, outerCache, node, nodeIndex, start, - dir = simple !== forward ? "nextSibling" : "previousSibling", - parent = elem.parentNode, - name = ofType && elem.nodeName.toLowerCase(), - useCache = !xml && !ofType, - diff = false; - - if ( parent ) { - - // :(first|last|only)-(child|of-type) - if ( simple ) { - while ( dir ) { - node = elem; - while ( ( node = node[ dir ] ) ) { - if ( ofType ? - node.nodeName.toLowerCase() === name : - node.nodeType === 1 ) { - - return false; - } - } - - // Reverse direction for :only-* (if we haven't yet done so) - start = dir = type === "only" && !start && "nextSibling"; - } - return true; - } - - start = [ forward ? parent.firstChild : parent.lastChild ]; - - // non-xml :nth-child(...) stores cache data on `parent` - if ( forward && useCache ) { - - // Seek `elem` from a previously-cached index - - // ...in a gzip-friendly way - node = parent; - outerCache = node[ expando ] || ( node[ expando ] = {} ); - - // Support: IE <9 only - // Defend against cloned attroperties (jQuery gh-1709) - uniqueCache = outerCache[ node.uniqueID ] || - ( outerCache[ node.uniqueID ] = {} ); - - cache = uniqueCache[ type ] || []; - nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; - diff = nodeIndex && cache[ 2 ]; - node = nodeIndex && parent.childNodes[ nodeIndex ]; - - while ( ( node = ++nodeIndex && node && node[ dir ] || - - // Fallback to seeking `elem` from the start - ( diff = nodeIndex = 0 ) || start.pop() ) ) { - - // When found, cache indexes on `parent` and break - if ( node.nodeType === 1 && ++diff && node === elem ) { - uniqueCache[ type ] = [ dirruns, nodeIndex, diff ]; - break; - } - } - - } else { - - // Use previously-cached element index if available - if ( useCache ) { - - // ...in a gzip-friendly way - node = elem; - outerCache = node[ expando ] || ( node[ expando ] = {} ); - - // Support: IE <9 only - // Defend against cloned attroperties (jQuery gh-1709) - uniqueCache = outerCache[ node.uniqueID ] || - ( outerCache[ node.uniqueID ] = {} ); - - cache = uniqueCache[ type ] || []; - nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; - diff = nodeIndex; - } - - // xml :nth-child(...) - // or :nth-last-child(...) or :nth(-last)?-of-type(...) - if ( diff === false ) { - - // Use the same loop as above to seek `elem` from the start - while ( ( node = ++nodeIndex && node && node[ dir ] || - ( diff = nodeIndex = 0 ) || start.pop() ) ) { - - if ( ( ofType ? - node.nodeName.toLowerCase() === name : - node.nodeType === 1 ) && - ++diff ) { - - // Cache the index of each encountered element - if ( useCache ) { - outerCache = node[ expando ] || - ( node[ expando ] = {} ); - - // Support: IE <9 only - // Defend against cloned attroperties (jQuery gh-1709) - uniqueCache = outerCache[ node.uniqueID ] || - ( outerCache[ node.uniqueID ] = {} ); - - uniqueCache[ type ] = [ dirruns, diff ]; - } - - if ( node === elem ) { - break; - } - } - } - } - } - - // Incorporate the offset, then check against cycle size - diff -= last; - return diff === first || ( diff % first === 0 && diff / first >= 0 ); - } - }; - }, - - "PSEUDO": function( pseudo, argument ) { - - // pseudo-class names are case-insensitive - // http://www.w3.org/TR/selectors/#pseudo-classes - // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters - // Remember that setFilters inherits from pseudos - var args, - fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || - Sizzle.error( "unsupported pseudo: " + pseudo ); - - // The user may use createPseudo to indicate that - // arguments are needed to create the filter function - // just as Sizzle does - if ( fn[ expando ] ) { - return fn( argument ); - } - - // But maintain support for old signatures - if ( fn.length > 1 ) { - args = [ pseudo, pseudo, "", argument ]; - return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? - markFunction( function( seed, matches ) { - var idx, - matched = fn( seed, argument ), - i = matched.length; - while ( i-- ) { - idx = indexOf( seed, matched[ i ] ); - seed[ idx ] = !( matches[ idx ] = matched[ i ] ); - } - } ) : - function( elem ) { - return fn( elem, 0, args ); - }; - } - - return fn; - } - }, - - pseudos: { - - // Potentially complex pseudos - "not": markFunction( function( selector ) { - - // Trim the selector passed to compile - // to avoid treating leading and trailing - // spaces as combinators - var input = [], - results = [], - matcher = compile( selector.replace( rtrim, "$1" ) ); - - return matcher[ expando ] ? - markFunction( function( seed, matches, _context, xml ) { - var elem, - unmatched = matcher( seed, null, xml, [] ), - i = seed.length; - - // Match elements unmatched by `matcher` - while ( i-- ) { - if ( ( elem = unmatched[ i ] ) ) { - seed[ i ] = !( matches[ i ] = elem ); - } - } - } ) : - function( elem, _context, xml ) { - input[ 0 ] = elem; - matcher( input, null, xml, results ); - - // Don't keep the element (issue #299) - input[ 0 ] = null; - return !results.pop(); - }; - } ), - - "has": markFunction( function( selector ) { - return function( elem ) { - return Sizzle( selector, elem ).length > 0; - }; - } ), - - "contains": markFunction( function( text ) { - text = text.replace( runescape, funescape ); - return function( elem ) { - return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1; - }; - } ), - - // "Whether an element is represented by a :lang() selector - // is based solely on the element's language value - // being equal to the identifier C, - // or beginning with the identifier C immediately followed by "-". - // The matching of C against the element's language value is performed case-insensitively. - // The identifier C does not have to be a valid language name." - // http://www.w3.org/TR/selectors/#lang-pseudo - "lang": markFunction( function( lang ) { - - // lang value must be a valid identifier - if ( !ridentifier.test( lang || "" ) ) { - Sizzle.error( "unsupported lang: " + lang ); - } - lang = lang.replace( runescape, funescape ).toLowerCase(); - return function( elem ) { - var elemLang; - do { - if ( ( elemLang = documentIsHTML ? - elem.lang : - elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) { - - elemLang = elemLang.toLowerCase(); - return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; - } - } while ( ( elem = elem.parentNode ) && elem.nodeType === 1 ); - return false; - }; - } ), - - // Miscellaneous - "target": function( elem ) { - var hash = window.location && window.location.hash; - return hash && hash.slice( 1 ) === elem.id; - }, - - "root": function( elem ) { - return elem === docElem; - }, - - "focus": function( elem ) { - return elem === document.activeElement && - ( !document.hasFocus || document.hasFocus() ) && - !!( elem.type || elem.href || ~elem.tabIndex ); - }, - - // Boolean properties - "enabled": createDisabledPseudo( false ), - "disabled": createDisabledPseudo( true ), - - "checked": function( elem ) { - - // In CSS3, :checked should return both checked and selected elements - // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked - var nodeName = elem.nodeName.toLowerCase(); - return ( nodeName === "input" && !!elem.checked ) || - ( nodeName === "option" && !!elem.selected ); - }, - - "selected": function( elem ) { - - // Accessing this property makes selected-by-default - // options in Safari work properly - if ( elem.parentNode ) { - // eslint-disable-next-line no-unused-expressions - elem.parentNode.selectedIndex; - } - - return elem.selected === true; - }, - - // Contents - "empty": function( elem ) { - - // http://www.w3.org/TR/selectors/#empty-pseudo - // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), - // but not by others (comment: 8; processing instruction: 7; etc.) - // nodeType < 6 works because attributes (2) do not appear as children - for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { - if ( elem.nodeType < 6 ) { - return false; - } - } - return true; - }, - - "parent": function( elem ) { - return !Expr.pseudos[ "empty" ]( elem ); - }, - - // Element/input types - "header": function( elem ) { - return rheader.test( elem.nodeName ); - }, - - "input": function( elem ) { - return rinputs.test( elem.nodeName ); - }, - - "button": function( elem ) { - var name = elem.nodeName.toLowerCase(); - return name === "input" && elem.type === "button" || name === "button"; - }, - - "text": function( elem ) { - var attr; - return elem.nodeName.toLowerCase() === "input" && - elem.type === "text" && - - // Support: IE<8 - // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" - ( ( attr = elem.getAttribute( "type" ) ) == null || - attr.toLowerCase() === "text" ); - }, - - // Position-in-collection - "first": createPositionalPseudo( function() { - return [ 0 ]; - } ), - - "last": createPositionalPseudo( function( _matchIndexes, length ) { - return [ length - 1 ]; - } ), - - "eq": createPositionalPseudo( function( _matchIndexes, length, argument ) { - return [ argument < 0 ? argument + length : argument ]; - } ), - - "even": createPositionalPseudo( function( matchIndexes, length ) { - var i = 0; - for ( ; i < length; i += 2 ) { - matchIndexes.push( i ); - } - return matchIndexes; - } ), - - "odd": createPositionalPseudo( function( matchIndexes, length ) { - var i = 1; - for ( ; i < length; i += 2 ) { - matchIndexes.push( i ); - } - return matchIndexes; - } ), - - "lt": createPositionalPseudo( function( matchIndexes, length, argument ) { - var i = argument < 0 ? - argument + length : - argument > length ? - length : - argument; - for ( ; --i >= 0; ) { - matchIndexes.push( i ); - } - return matchIndexes; - } ), - - "gt": createPositionalPseudo( function( matchIndexes, length, argument ) { - var i = argument < 0 ? argument + length : argument; - for ( ; ++i < length; ) { - matchIndexes.push( i ); - } - return matchIndexes; - } ) - } -}; - -Expr.pseudos[ "nth" ] = Expr.pseudos[ "eq" ]; - -// Add button/input type pseudos -for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { - Expr.pseudos[ i ] = createInputPseudo( i ); -} -for ( i in { submit: true, reset: true } ) { - Expr.pseudos[ i ] = createButtonPseudo( i ); -} - -// Easy API for creating new setFilters -function setFilters() {} -setFilters.prototype = Expr.filters = Expr.pseudos; -Expr.setFilters = new setFilters(); - -tokenize = Sizzle.tokenize = function( selector, parseOnly ) { - var matched, match, tokens, type, - soFar, groups, preFilters, - cached = tokenCache[ selector + " " ]; - - if ( cached ) { - return parseOnly ? 0 : cached.slice( 0 ); - } - - soFar = selector; - groups = []; - preFilters = Expr.preFilter; - - while ( soFar ) { - - // Comma and first run - if ( !matched || ( match = rcomma.exec( soFar ) ) ) { - if ( match ) { - - // Don't consume trailing commas as valid - soFar = soFar.slice( match[ 0 ].length ) || soFar; - } - groups.push( ( tokens = [] ) ); - } - - matched = false; - - // Combinators - if ( ( match = rcombinators.exec( soFar ) ) ) { - matched = match.shift(); - tokens.push( { - value: matched, - - // Cast descendant combinators to space - type: match[ 0 ].replace( rtrim, " " ) - } ); - soFar = soFar.slice( matched.length ); - } - - // Filters - for ( type in Expr.filter ) { - if ( ( match = matchExpr[ type ].exec( soFar ) ) && ( !preFilters[ type ] || - ( match = preFilters[ type ]( match ) ) ) ) { - matched = match.shift(); - tokens.push( { - value: matched, - type: type, - matches: match - } ); - soFar = soFar.slice( matched.length ); - } - } - - if ( !matched ) { - break; - } - } - - // Return the length of the invalid excess - // if we're just parsing - // Otherwise, throw an error or return tokens - return parseOnly ? - soFar.length : - soFar ? - Sizzle.error( selector ) : - - // Cache the tokens - tokenCache( selector, groups ).slice( 0 ); -}; - -function toSelector( tokens ) { - var i = 0, - len = tokens.length, - selector = ""; - for ( ; i < len; i++ ) { - selector += tokens[ i ].value; - } - return selector; -} - -function addCombinator( matcher, combinator, base ) { - var dir = combinator.dir, - skip = combinator.next, - key = skip || dir, - checkNonElements = base && key === "parentNode", - doneName = done++; - - return combinator.first ? - - // Check against closest ancestor/preceding element - function( elem, context, xml ) { - while ( ( elem = elem[ dir ] ) ) { - if ( elem.nodeType === 1 || checkNonElements ) { - return matcher( elem, context, xml ); - } - } - return false; - } : - - // Check against all ancestor/preceding elements - function( elem, context, xml ) { - var oldCache, uniqueCache, outerCache, - newCache = [ dirruns, doneName ]; - - // We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching - if ( xml ) { - while ( ( elem = elem[ dir ] ) ) { - if ( elem.nodeType === 1 || checkNonElements ) { - if ( matcher( elem, context, xml ) ) { - return true; - } - } - } - } else { - while ( ( elem = elem[ dir ] ) ) { - if ( elem.nodeType === 1 || checkNonElements ) { - outerCache = elem[ expando ] || ( elem[ expando ] = {} ); - - // Support: IE <9 only - // Defend against cloned attroperties (jQuery gh-1709) - uniqueCache = outerCache[ elem.uniqueID ] || - ( outerCache[ elem.uniqueID ] = {} ); - - if ( skip && skip === elem.nodeName.toLowerCase() ) { - elem = elem[ dir ] || elem; - } else if ( ( oldCache = uniqueCache[ key ] ) && - oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { - - // Assign to newCache so results back-propagate to previous elements - return ( newCache[ 2 ] = oldCache[ 2 ] ); - } else { - - // Reuse newcache so results back-propagate to previous elements - uniqueCache[ key ] = newCache; - - // A match means we're done; a fail means we have to keep checking - if ( ( newCache[ 2 ] = matcher( elem, context, xml ) ) ) { - return true; - } - } - } - } - } - return false; - }; -} - -function elementMatcher( matchers ) { - return matchers.length > 1 ? - function( elem, context, xml ) { - var i = matchers.length; - while ( i-- ) { - if ( !matchers[ i ]( elem, context, xml ) ) { - return false; - } - } - return true; - } : - matchers[ 0 ]; -} - -function multipleContexts( selector, contexts, results ) { - var i = 0, - len = contexts.length; - for ( ; i < len; i++ ) { - Sizzle( selector, contexts[ i ], results ); - } - return results; -} - -function condense( unmatched, map, filter, context, xml ) { - var elem, - newUnmatched = [], - i = 0, - len = unmatched.length, - mapped = map != null; - - for ( ; i < len; i++ ) { - if ( ( elem = unmatched[ i ] ) ) { - if ( !filter || filter( elem, context, xml ) ) { - newUnmatched.push( elem ); - if ( mapped ) { - map.push( i ); - } - } - } - } - - return newUnmatched; -} - -function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { - if ( postFilter && !postFilter[ expando ] ) { - postFilter = setMatcher( postFilter ); - } - if ( postFinder && !postFinder[ expando ] ) { - postFinder = setMatcher( postFinder, postSelector ); - } - return markFunction( function( seed, results, context, xml ) { - var temp, i, elem, - preMap = [], - postMap = [], - preexisting = results.length, - - // Get initial elements from seed or context - elems = seed || multipleContexts( - selector || "*", - context.nodeType ? [ context ] : context, - [] - ), - - // Prefilter to get matcher input, preserving a map for seed-results synchronization - matcherIn = preFilter && ( seed || !selector ) ? - condense( elems, preMap, preFilter, context, xml ) : - elems, - - matcherOut = matcher ? - - // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, - postFinder || ( seed ? preFilter : preexisting || postFilter ) ? - - // ...intermediate processing is necessary - [] : - - // ...otherwise use results directly - results : - matcherIn; - - // Find primary matches - if ( matcher ) { - matcher( matcherIn, matcherOut, context, xml ); - } - - // Apply postFilter - if ( postFilter ) { - temp = condense( matcherOut, postMap ); - postFilter( temp, [], context, xml ); - - // Un-match failing elements by moving them back to matcherIn - i = temp.length; - while ( i-- ) { - if ( ( elem = temp[ i ] ) ) { - matcherOut[ postMap[ i ] ] = !( matcherIn[ postMap[ i ] ] = elem ); - } - } - } - - if ( seed ) { - if ( postFinder || preFilter ) { - if ( postFinder ) { - - // Get the final matcherOut by condensing this intermediate into postFinder contexts - temp = []; - i = matcherOut.length; - while ( i-- ) { - if ( ( elem = matcherOut[ i ] ) ) { - - // Restore matcherIn since elem is not yet a final match - temp.push( ( matcherIn[ i ] = elem ) ); - } - } - postFinder( null, ( matcherOut = [] ), temp, xml ); - } - - // Move matched elements from seed to results to keep them synchronized - i = matcherOut.length; - while ( i-- ) { - if ( ( elem = matcherOut[ i ] ) && - ( temp = postFinder ? indexOf( seed, elem ) : preMap[ i ] ) > -1 ) { - - seed[ temp ] = !( results[ temp ] = elem ); - } - } - } - - // Add elements to results, through postFinder if defined - } else { - matcherOut = condense( - matcherOut === results ? - matcherOut.splice( preexisting, matcherOut.length ) : - matcherOut - ); - if ( postFinder ) { - postFinder( null, results, matcherOut, xml ); - } else { - push.apply( results, matcherOut ); - } - } - } ); -} - -function matcherFromTokens( tokens ) { - var checkContext, matcher, j, - len = tokens.length, - leadingRelative = Expr.relative[ tokens[ 0 ].type ], - implicitRelative = leadingRelative || Expr.relative[ " " ], - i = leadingRelative ? 1 : 0, - - // The foundational matcher ensures that elements are reachable from top-level context(s) - matchContext = addCombinator( function( elem ) { - return elem === checkContext; - }, implicitRelative, true ), - matchAnyContext = addCombinator( function( elem ) { - return indexOf( checkContext, elem ) > -1; - }, implicitRelative, true ), - matchers = [ function( elem, context, xml ) { - var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( - ( checkContext = context ).nodeType ? - matchContext( elem, context, xml ) : - matchAnyContext( elem, context, xml ) ); - - // Avoid hanging onto element (issue #299) - checkContext = null; - return ret; - } ]; - - for ( ; i < len; i++ ) { - if ( ( matcher = Expr.relative[ tokens[ i ].type ] ) ) { - matchers = [ addCombinator( elementMatcher( matchers ), matcher ) ]; - } else { - matcher = Expr.filter[ tokens[ i ].type ].apply( null, tokens[ i ].matches ); - - // Return special upon seeing a positional matcher - if ( matcher[ expando ] ) { - - // Find the next relative operator (if any) for proper handling - j = ++i; - for ( ; j < len; j++ ) { - if ( Expr.relative[ tokens[ j ].type ] ) { - break; - } - } - return setMatcher( - i > 1 && elementMatcher( matchers ), - i > 1 && toSelector( - - // If the preceding token was a descendant combinator, insert an implicit any-element `*` - tokens - .slice( 0, i - 1 ) - .concat( { value: tokens[ i - 2 ].type === " " ? "*" : "" } ) - ).replace( rtrim, "$1" ), - matcher, - i < j && matcherFromTokens( tokens.slice( i, j ) ), - j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ), - j < len && toSelector( tokens ) - ); - } - matchers.push( matcher ); - } - } - - return elementMatcher( matchers ); -} - -function matcherFromGroupMatchers( elementMatchers, setMatchers ) { - var bySet = setMatchers.length > 0, - byElement = elementMatchers.length > 0, - superMatcher = function( seed, context, xml, results, outermost ) { - var elem, j, matcher, - matchedCount = 0, - i = "0", - unmatched = seed && [], - setMatched = [], - contextBackup = outermostContext, - - // We must always have either seed elements or outermost context - elems = seed || byElement && Expr.find[ "TAG" ]( "*", outermost ), - - // Use integer dirruns iff this is the outermost matcher - dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ), - len = elems.length; - - if ( outermost ) { - - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - outermostContext = context == document || context || outermost; - } - - // Add elements passing elementMatchers directly to results - // Support: IE<9, Safari - // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id - for ( ; i !== len && ( elem = elems[ i ] ) != null; i++ ) { - if ( byElement && elem ) { - j = 0; - - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( !context && elem.ownerDocument != document ) { - setDocument( elem ); - xml = !documentIsHTML; - } - while ( ( matcher = elementMatchers[ j++ ] ) ) { - if ( matcher( elem, context || document, xml ) ) { - results.push( elem ); - break; - } - } - if ( outermost ) { - dirruns = dirrunsUnique; - } - } - - // Track unmatched elements for set filters - if ( bySet ) { - - // They will have gone through all possible matchers - if ( ( elem = !matcher && elem ) ) { - matchedCount--; - } - - // Lengthen the array for every element, matched or not - if ( seed ) { - unmatched.push( elem ); - } - } - } - - // `i` is now the count of elements visited above, and adding it to `matchedCount` - // makes the latter nonnegative. - matchedCount += i; - - // Apply set filters to unmatched elements - // NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount` - // equals `i`), unless we didn't visit _any_ elements in the above loop because we have - // no element matchers and no seed. - // Incrementing an initially-string "0" `i` allows `i` to remain a string only in that - // case, which will result in a "00" `matchedCount` that differs from `i` but is also - // numerically zero. - if ( bySet && i !== matchedCount ) { - j = 0; - while ( ( matcher = setMatchers[ j++ ] ) ) { - matcher( unmatched, setMatched, context, xml ); - } - - if ( seed ) { - - // Reintegrate element matches to eliminate the need for sorting - if ( matchedCount > 0 ) { - while ( i-- ) { - if ( !( unmatched[ i ] || setMatched[ i ] ) ) { - setMatched[ i ] = pop.call( results ); - } - } - } - - // Discard index placeholder values to get only actual matches - setMatched = condense( setMatched ); - } - - // Add matches to results - push.apply( results, setMatched ); - - // Seedless set matches succeeding multiple successful matchers stipulate sorting - if ( outermost && !seed && setMatched.length > 0 && - ( matchedCount + setMatchers.length ) > 1 ) { - - Sizzle.uniqueSort( results ); - } - } - - // Override manipulation of globals by nested matchers - if ( outermost ) { - dirruns = dirrunsUnique; - outermostContext = contextBackup; - } - - return unmatched; - }; - - return bySet ? - markFunction( superMatcher ) : - superMatcher; -} - -compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { - var i, - setMatchers = [], - elementMatchers = [], - cached = compilerCache[ selector + " " ]; - - if ( !cached ) { - - // Generate a function of recursive functions that can be used to check each element - if ( !match ) { - match = tokenize( selector ); - } - i = match.length; - while ( i-- ) { - cached = matcherFromTokens( match[ i ] ); - if ( cached[ expando ] ) { - setMatchers.push( cached ); - } else { - elementMatchers.push( cached ); - } - } - - // Cache the compiled function - cached = compilerCache( - selector, - matcherFromGroupMatchers( elementMatchers, setMatchers ) - ); - - // Save selector and tokenization - cached.selector = selector; - } - return cached; -}; - -/** - * A low-level selection function that works with Sizzle's compiled - * selector functions - * @param {String|Function} selector A selector or a pre-compiled - * selector function built with Sizzle.compile - * @param {Element} context - * @param {Array} [results] - * @param {Array} [seed] A set of elements to match against - */ -select = Sizzle.select = function( selector, context, results, seed ) { - var i, tokens, token, type, find, - compiled = typeof selector === "function" && selector, - match = !seed && tokenize( ( selector = compiled.selector || selector ) ); - - results = results || []; - - // Try to minimize operations if there is only one selector in the list and no seed - // (the latter of which guarantees us context) - if ( match.length === 1 ) { - - // Reduce context if the leading compound selector is an ID - tokens = match[ 0 ] = match[ 0 ].slice( 0 ); - if ( tokens.length > 2 && ( token = tokens[ 0 ] ).type === "ID" && - context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[ 1 ].type ] ) { - - context = ( Expr.find[ "ID" ]( token.matches[ 0 ] - .replace( runescape, funescape ), context ) || [] )[ 0 ]; - if ( !context ) { - return results; - - // Precompiled matchers will still verify ancestry, so step up a level - } else if ( compiled ) { - context = context.parentNode; - } - - selector = selector.slice( tokens.shift().value.length ); - } - - // Fetch a seed set for right-to-left matching - i = matchExpr[ "needsContext" ].test( selector ) ? 0 : tokens.length; - while ( i-- ) { - token = tokens[ i ]; - - // Abort if we hit a combinator - if ( Expr.relative[ ( type = token.type ) ] ) { - break; - } - if ( ( find = Expr.find[ type ] ) ) { - - // Search, expanding context for leading sibling combinators - if ( ( seed = find( - token.matches[ 0 ].replace( runescape, funescape ), - rsibling.test( tokens[ 0 ].type ) && testContext( context.parentNode ) || - context - ) ) ) { - - // If seed is empty or no tokens remain, we can return early - tokens.splice( i, 1 ); - selector = seed.length && toSelector( tokens ); - if ( !selector ) { - push.apply( results, seed ); - return results; - } - - break; - } - } - } - } - - // Compile and execute a filtering function if one is not provided - // Provide `match` to avoid retokenization if we modified the selector above - ( compiled || compile( selector, match ) )( - seed, - context, - !documentIsHTML, - results, - !context || rsibling.test( selector ) && testContext( context.parentNode ) || context - ); - return results; -}; - -// One-time assignments - -// Sort stability -support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando; - -// Support: Chrome 14-35+ -// Always assume duplicates if they aren't passed to the comparison function -support.detectDuplicates = !!hasDuplicate; - -// Initialize against the default document -setDocument(); - -// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) -// Detached nodes confoundingly follow *each other* -support.sortDetached = assert( function( el ) { - - // Should return 1, but returns 4 (following) - return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1; -} ); - -// Support: IE<8 -// Prevent attribute/property "interpolation" -// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx -if ( !assert( function( el ) { - el.innerHTML = ""; - return el.firstChild.getAttribute( "href" ) === "#"; -} ) ) { - addHandle( "type|href|height|width", function( elem, name, isXML ) { - if ( !isXML ) { - return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); - } - } ); -} - -// Support: IE<9 -// Use defaultValue in place of getAttribute("value") -if ( !support.attributes || !assert( function( el ) { - el.innerHTML = ""; - el.firstChild.setAttribute( "value", "" ); - return el.firstChild.getAttribute( "value" ) === ""; -} ) ) { - addHandle( "value", function( elem, _name, isXML ) { - if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { - return elem.defaultValue; - } - } ); -} - -// Support: IE<9 -// Use getAttributeNode to fetch booleans when getAttribute lies -if ( !assert( function( el ) { - return el.getAttribute( "disabled" ) == null; -} ) ) { - addHandle( booleans, function( elem, name, isXML ) { - var val; - if ( !isXML ) { - return elem[ name ] === true ? name.toLowerCase() : - ( val = elem.getAttributeNode( name ) ) && val.specified ? - val.value : - null; - } - } ); -} - -return Sizzle; - -} )( window ); - - - -jQuery.find = Sizzle; -jQuery.expr = Sizzle.selectors; - -// Deprecated -jQuery.expr[ ":" ] = jQuery.expr.pseudos; -jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort; -jQuery.text = Sizzle.getText; -jQuery.isXMLDoc = Sizzle.isXML; -jQuery.contains = Sizzle.contains; -jQuery.escapeSelector = Sizzle.escape; - - - - -var dir = function( elem, dir, until ) { - var matched = [], - truncate = until !== undefined; - - while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) { - if ( elem.nodeType === 1 ) { - if ( truncate && jQuery( elem ).is( until ) ) { - break; - } - matched.push( elem ); - } - } - return matched; -}; - - -var siblings = function( n, elem ) { - var matched = []; - - for ( ; n; n = n.nextSibling ) { - if ( n.nodeType === 1 && n !== elem ) { - matched.push( n ); - } - } - - return matched; -}; - - -var rneedsContext = jQuery.expr.match.needsContext; - - - -function nodeName( elem, name ) { - - return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); - -} -var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i ); - - - -// Implement the identical functionality for filter and not -function winnow( elements, qualifier, not ) { - if ( isFunction( qualifier ) ) { - return jQuery.grep( elements, function( elem, i ) { - return !!qualifier.call( elem, i, elem ) !== not; - } ); - } - - // Single element - if ( qualifier.nodeType ) { - return jQuery.grep( elements, function( elem ) { - return ( elem === qualifier ) !== not; - } ); - } - - // Arraylike of elements (jQuery, arguments, Array) - if ( typeof qualifier !== "string" ) { - return jQuery.grep( elements, function( elem ) { - return ( indexOf.call( qualifier, elem ) > -1 ) !== not; - } ); - } - - // Filtered directly for both simple and complex selectors - return jQuery.filter( qualifier, elements, not ); -} - -jQuery.filter = function( expr, elems, not ) { - var elem = elems[ 0 ]; - - if ( not ) { - expr = ":not(" + expr + ")"; - } - - if ( elems.length === 1 && elem.nodeType === 1 ) { - return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : []; - } - - return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { - return elem.nodeType === 1; - } ) ); -}; - -jQuery.fn.extend( { - find: function( selector ) { - var i, ret, - len = this.length, - self = this; - - if ( typeof selector !== "string" ) { - return this.pushStack( jQuery( selector ).filter( function() { - for ( i = 0; i < len; i++ ) { - if ( jQuery.contains( self[ i ], this ) ) { - return true; - } - } - } ) ); - } - - ret = this.pushStack( [] ); - - for ( i = 0; i < len; i++ ) { - jQuery.find( selector, self[ i ], ret ); - } - - return len > 1 ? jQuery.uniqueSort( ret ) : ret; - }, - filter: function( selector ) { - return this.pushStack( winnow( this, selector || [], false ) ); - }, - not: function( selector ) { - return this.pushStack( winnow( this, selector || [], true ) ); - }, - is: function( selector ) { - return !!winnow( - this, - - // If this is a positional/relative selector, check membership in the returned set - // so $("p:first").is("p:last") won't return true for a doc with two "p". - typeof selector === "string" && rneedsContext.test( selector ) ? - jQuery( selector ) : - selector || [], - false - ).length; - } -} ); - - -// Initialize a jQuery object - - -// A central reference to the root jQuery(document) -var rootjQuery, - - // A simple way to check for HTML strings - // Prioritize #id over to avoid XSS via location.hash (#9521) - // Strict HTML recognition (#11290: must start with <) - // Shortcut simple #id case for speed - rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/, - - init = jQuery.fn.init = function( selector, context, root ) { - var match, elem; - - // HANDLE: $(""), $(null), $(undefined), $(false) - if ( !selector ) { - return this; - } - - // Method init() accepts an alternate rootjQuery - // so migrate can support jQuery.sub (gh-2101) - root = root || rootjQuery; - - // Handle HTML strings - if ( typeof selector === "string" ) { - if ( selector[ 0 ] === "<" && - selector[ selector.length - 1 ] === ">" && - selector.length >= 3 ) { - - // Assume that strings that start and end with <> are HTML and skip the regex check - match = [ null, selector, null ]; - - } else { - match = rquickExpr.exec( selector ); - } - - // Match html or make sure no context is specified for #id - if ( match && ( match[ 1 ] || !context ) ) { - - // HANDLE: $(html) -> $(array) - if ( match[ 1 ] ) { - context = context instanceof jQuery ? context[ 0 ] : context; - - // Option to run scripts is true for back-compat - // Intentionally let the error be thrown if parseHTML is not present - jQuery.merge( this, jQuery.parseHTML( - match[ 1 ], - context && context.nodeType ? context.ownerDocument || context : document, - true - ) ); - - // HANDLE: $(html, props) - if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) { - for ( match in context ) { - - // Properties of context are called as methods if possible - if ( isFunction( this[ match ] ) ) { - this[ match ]( context[ match ] ); - - // ...and otherwise set as attributes - } else { - this.attr( match, context[ match ] ); - } - } - } - - return this; - - // HANDLE: $(#id) - } else { - elem = document.getElementById( match[ 2 ] ); - - if ( elem ) { - - // Inject the element directly into the jQuery object - this[ 0 ] = elem; - this.length = 1; - } - return this; - } - - // HANDLE: $(expr, $(...)) - } else if ( !context || context.jquery ) { - return ( context || root ).find( selector ); - - // HANDLE: $(expr, context) - // (which is just equivalent to: $(context).find(expr) - } else { - return this.constructor( context ).find( selector ); - } - - // HANDLE: $(DOMElement) - } else if ( selector.nodeType ) { - this[ 0 ] = selector; - this.length = 1; - return this; - - // HANDLE: $(function) - // Shortcut for document ready - } else if ( isFunction( selector ) ) { - return root.ready !== undefined ? - root.ready( selector ) : - - // Execute immediately if ready is not present - selector( jQuery ); - } - - return jQuery.makeArray( selector, this ); - }; - -// Give the init function the jQuery prototype for later instantiation -init.prototype = jQuery.fn; - -// Initialize central reference -rootjQuery = jQuery( document ); - - -var rparentsprev = /^(?:parents|prev(?:Until|All))/, - - // Methods guaranteed to produce a unique set when starting from a unique set - guaranteedUnique = { - children: true, - contents: true, - next: true, - prev: true - }; - -jQuery.fn.extend( { - has: function( target ) { - var targets = jQuery( target, this ), - l = targets.length; - - return this.filter( function() { - var i = 0; - for ( ; i < l; i++ ) { - if ( jQuery.contains( this, targets[ i ] ) ) { - return true; - } - } - } ); - }, - - closest: function( selectors, context ) { - var cur, - i = 0, - l = this.length, - matched = [], - targets = typeof selectors !== "string" && jQuery( selectors ); - - // Positional selectors never match, since there's no _selection_ context - if ( !rneedsContext.test( selectors ) ) { - for ( ; i < l; i++ ) { - for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) { - - // Always skip document fragments - if ( cur.nodeType < 11 && ( targets ? - targets.index( cur ) > -1 : - - // Don't pass non-elements to Sizzle - cur.nodeType === 1 && - jQuery.find.matchesSelector( cur, selectors ) ) ) { - - matched.push( cur ); - break; - } - } - } - } - - return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched ); - }, - - // Determine the position of an element within the set - index: function( elem ) { - - // No argument, return index in parent - if ( !elem ) { - return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; - } - - // Index in selector - if ( typeof elem === "string" ) { - return indexOf.call( jQuery( elem ), this[ 0 ] ); - } - - // Locate the position of the desired element - return indexOf.call( this, - - // If it receives a jQuery object, the first element is used - elem.jquery ? elem[ 0 ] : elem - ); - }, - - add: function( selector, context ) { - return this.pushStack( - jQuery.uniqueSort( - jQuery.merge( this.get(), jQuery( selector, context ) ) - ) - ); - }, - - addBack: function( selector ) { - return this.add( selector == null ? - this.prevObject : this.prevObject.filter( selector ) - ); - } -} ); - -function sibling( cur, dir ) { - while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {} - return cur; -} - -jQuery.each( { - parent: function( elem ) { - var parent = elem.parentNode; - return parent && parent.nodeType !== 11 ? parent : null; - }, - parents: function( elem ) { - return dir( elem, "parentNode" ); - }, - parentsUntil: function( elem, _i, until ) { - return dir( elem, "parentNode", until ); - }, - next: function( elem ) { - return sibling( elem, "nextSibling" ); - }, - prev: function( elem ) { - return sibling( elem, "previousSibling" ); - }, - nextAll: function( elem ) { - return dir( elem, "nextSibling" ); - }, - prevAll: function( elem ) { - return dir( elem, "previousSibling" ); - }, - nextUntil: function( elem, _i, until ) { - return dir( elem, "nextSibling", until ); - }, - prevUntil: function( elem, _i, until ) { - return dir( elem, "previousSibling", until ); - }, - siblings: function( elem ) { - return siblings( ( elem.parentNode || {} ).firstChild, elem ); - }, - children: function( elem ) { - return siblings( elem.firstChild ); - }, - contents: function( elem ) { - if ( elem.contentDocument != null && - - // Support: IE 11+ - // elements with no `data` attribute has an object - // `contentDocument` with a `null` prototype. - getProto( elem.contentDocument ) ) { - - return elem.contentDocument; - } - - // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only - // Treat the template element as a regular one in browsers that - // don't support it. - if ( nodeName( elem, "template" ) ) { - elem = elem.content || elem; - } - - return jQuery.merge( [], elem.childNodes ); - } -}, function( name, fn ) { - jQuery.fn[ name ] = function( until, selector ) { - var matched = jQuery.map( this, fn, until ); - - if ( name.slice( -5 ) !== "Until" ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - matched = jQuery.filter( selector, matched ); - } - - if ( this.length > 1 ) { - - // Remove duplicates - if ( !guaranteedUnique[ name ] ) { - jQuery.uniqueSort( matched ); - } - - // Reverse order for parents* and prev-derivatives - if ( rparentsprev.test( name ) ) { - matched.reverse(); - } - } - - return this.pushStack( matched ); - }; -} ); -var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g ); - - - -// Convert String-formatted options into Object-formatted ones -function createOptions( options ) { - var object = {}; - jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) { - object[ flag ] = true; - } ); - return object; -} - -/* - * Create a callback list using the following parameters: - * - * options: an optional list of space-separated options that will change how - * the callback list behaves or a more traditional option object - * - * By default a callback list will act like an event callback list and can be - * "fired" multiple times. - * - * Possible options: - * - * once: will ensure the callback list can only be fired once (like a Deferred) - * - * memory: will keep track of previous values and will call any callback added - * after the list has been fired right away with the latest "memorized" - * values (like a Deferred) - * - * unique: will ensure a callback can only be added once (no duplicate in the list) - * - * stopOnFalse: interrupt callings when a callback returns false - * - */ -jQuery.Callbacks = function( options ) { - - // Convert options from String-formatted to Object-formatted if needed - // (we check in cache first) - options = typeof options === "string" ? - createOptions( options ) : - jQuery.extend( {}, options ); - - var // Flag to know if list is currently firing - firing, - - // Last fire value for non-forgettable lists - memory, - - // Flag to know if list was already fired - fired, - - // Flag to prevent firing - locked, - - // Actual callback list - list = [], - - // Queue of execution data for repeatable lists - queue = [], - - // Index of currently firing callback (modified by add/remove as needed) - firingIndex = -1, - - // Fire callbacks - fire = function() { - - // Enforce single-firing - locked = locked || options.once; - - // Execute callbacks for all pending executions, - // respecting firingIndex overrides and runtime changes - fired = firing = true; - for ( ; queue.length; firingIndex = -1 ) { - memory = queue.shift(); - while ( ++firingIndex < list.length ) { - - // Run callback and check for early termination - if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false && - options.stopOnFalse ) { - - // Jump to end and forget the data so .add doesn't re-fire - firingIndex = list.length; - memory = false; - } - } - } - - // Forget the data if we're done with it - if ( !options.memory ) { - memory = false; - } - - firing = false; - - // Clean up if we're done firing for good - if ( locked ) { - - // Keep an empty list if we have data for future add calls - if ( memory ) { - list = []; - - // Otherwise, this object is spent - } else { - list = ""; - } - } - }, - - // Actual Callbacks object - self = { - - // Add a callback or a collection of callbacks to the list - add: function() { - if ( list ) { - - // If we have memory from a past run, we should fire after adding - if ( memory && !firing ) { - firingIndex = list.length - 1; - queue.push( memory ); - } - - ( function add( args ) { - jQuery.each( args, function( _, arg ) { - if ( isFunction( arg ) ) { - if ( !options.unique || !self.has( arg ) ) { - list.push( arg ); - } - } else if ( arg && arg.length && toType( arg ) !== "string" ) { - - // Inspect recursively - add( arg ); - } - } ); - } )( arguments ); - - if ( memory && !firing ) { - fire(); - } - } - return this; - }, - - // Remove a callback from the list - remove: function() { - jQuery.each( arguments, function( _, arg ) { - var index; - while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { - list.splice( index, 1 ); - - // Handle firing indexes - if ( index <= firingIndex ) { - firingIndex--; - } - } - } ); - return this; - }, - - // Check if a given callback is in the list. - // If no argument is given, return whether or not list has callbacks attached. - has: function( fn ) { - return fn ? - jQuery.inArray( fn, list ) > -1 : - list.length > 0; - }, - - // Remove all callbacks from the list - empty: function() { - if ( list ) { - list = []; - } - return this; - }, - - // Disable .fire and .add - // Abort any current/pending executions - // Clear all callbacks and values - disable: function() { - locked = queue = []; - list = memory = ""; - return this; - }, - disabled: function() { - return !list; - }, - - // Disable .fire - // Also disable .add unless we have memory (since it would have no effect) - // Abort any pending executions - lock: function() { - locked = queue = []; - if ( !memory && !firing ) { - list = memory = ""; - } - return this; - }, - locked: function() { - return !!locked; - }, - - // Call all callbacks with the given context and arguments - fireWith: function( context, args ) { - if ( !locked ) { - args = args || []; - args = [ context, args.slice ? args.slice() : args ]; - queue.push( args ); - if ( !firing ) { - fire(); - } - } - return this; - }, - - // Call all the callbacks with the given arguments - fire: function() { - self.fireWith( this, arguments ); - return this; - }, - - // To know if the callbacks have already been called at least once - fired: function() { - return !!fired; - } - }; - - return self; -}; - - -function Identity( v ) { - return v; -} -function Thrower( ex ) { - throw ex; -} - -function adoptValue( value, resolve, reject, noValue ) { - var method; - - try { - - // Check for promise aspect first to privilege synchronous behavior - if ( value && isFunction( ( method = value.promise ) ) ) { - method.call( value ).done( resolve ).fail( reject ); - - // Other thenables - } else if ( value && isFunction( ( method = value.then ) ) ) { - method.call( value, resolve, reject ); - - // Other non-thenables - } else { - - // Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer: - // * false: [ value ].slice( 0 ) => resolve( value ) - // * true: [ value ].slice( 1 ) => resolve() - resolve.apply( undefined, [ value ].slice( noValue ) ); - } - - // For Promises/A+, convert exceptions into rejections - // Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in - // Deferred#then to conditionally suppress rejection. - } catch ( value ) { - - // Support: Android 4.0 only - // Strict mode functions invoked without .call/.apply get global-object context - reject.apply( undefined, [ value ] ); - } -} - -jQuery.extend( { - - Deferred: function( func ) { - var tuples = [ - - // action, add listener, callbacks, - // ... .then handlers, argument index, [final state] - [ "notify", "progress", jQuery.Callbacks( "memory" ), - jQuery.Callbacks( "memory" ), 2 ], - [ "resolve", "done", jQuery.Callbacks( "once memory" ), - jQuery.Callbacks( "once memory" ), 0, "resolved" ], - [ "reject", "fail", jQuery.Callbacks( "once memory" ), - jQuery.Callbacks( "once memory" ), 1, "rejected" ] - ], - state = "pending", - promise = { - state: function() { - return state; - }, - always: function() { - deferred.done( arguments ).fail( arguments ); - return this; - }, - "catch": function( fn ) { - return promise.then( null, fn ); - }, - - // Keep pipe for back-compat - pipe: function( /* fnDone, fnFail, fnProgress */ ) { - var fns = arguments; - - return jQuery.Deferred( function( newDefer ) { - jQuery.each( tuples, function( _i, tuple ) { - - // Map tuples (progress, done, fail) to arguments (done, fail, progress) - var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ]; - - // deferred.progress(function() { bind to newDefer or newDefer.notify }) - // deferred.done(function() { bind to newDefer or newDefer.resolve }) - // deferred.fail(function() { bind to newDefer or newDefer.reject }) - deferred[ tuple[ 1 ] ]( function() { - var returned = fn && fn.apply( this, arguments ); - if ( returned && isFunction( returned.promise ) ) { - returned.promise() - .progress( newDefer.notify ) - .done( newDefer.resolve ) - .fail( newDefer.reject ); - } else { - newDefer[ tuple[ 0 ] + "With" ]( - this, - fn ? [ returned ] : arguments - ); - } - } ); - } ); - fns = null; - } ).promise(); - }, - then: function( onFulfilled, onRejected, onProgress ) { - var maxDepth = 0; - function resolve( depth, deferred, handler, special ) { - return function() { - var that = this, - args = arguments, - mightThrow = function() { - var returned, then; - - // Support: Promises/A+ section 2.3.3.3.3 - // https://promisesaplus.com/#point-59 - // Ignore double-resolution attempts - if ( depth < maxDepth ) { - return; - } - - returned = handler.apply( that, args ); - - // Support: Promises/A+ section 2.3.1 - // https://promisesaplus.com/#point-48 - if ( returned === deferred.promise() ) { - throw new TypeError( "Thenable self-resolution" ); - } - - // Support: Promises/A+ sections 2.3.3.1, 3.5 - // https://promisesaplus.com/#point-54 - // https://promisesaplus.com/#point-75 - // Retrieve `then` only once - then = returned && - - // Support: Promises/A+ section 2.3.4 - // https://promisesaplus.com/#point-64 - // Only check objects and functions for thenability - ( typeof returned === "object" || - typeof returned === "function" ) && - returned.then; - - // Handle a returned thenable - if ( isFunction( then ) ) { - - // Special processors (notify) just wait for resolution - if ( special ) { - then.call( - returned, - resolve( maxDepth, deferred, Identity, special ), - resolve( maxDepth, deferred, Thrower, special ) - ); - - // Normal processors (resolve) also hook into progress - } else { - - // ...and disregard older resolution values - maxDepth++; - - then.call( - returned, - resolve( maxDepth, deferred, Identity, special ), - resolve( maxDepth, deferred, Thrower, special ), - resolve( maxDepth, deferred, Identity, - deferred.notifyWith ) - ); - } - - // Handle all other returned values - } else { - - // Only substitute handlers pass on context - // and multiple values (non-spec behavior) - if ( handler !== Identity ) { - that = undefined; - args = [ returned ]; - } - - // Process the value(s) - // Default process is resolve - ( special || deferred.resolveWith )( that, args ); - } - }, - - // Only normal processors (resolve) catch and reject exceptions - process = special ? - mightThrow : - function() { - try { - mightThrow(); - } catch ( e ) { - - if ( jQuery.Deferred.exceptionHook ) { - jQuery.Deferred.exceptionHook( e, - process.stackTrace ); - } - - // Support: Promises/A+ section 2.3.3.3.4.1 - // https://promisesaplus.com/#point-61 - // Ignore post-resolution exceptions - if ( depth + 1 >= maxDepth ) { - - // Only substitute handlers pass on context - // and multiple values (non-spec behavior) - if ( handler !== Thrower ) { - that = undefined; - args = [ e ]; - } - - deferred.rejectWith( that, args ); - } - } - }; - - // Support: Promises/A+ section 2.3.3.3.1 - // https://promisesaplus.com/#point-57 - // Re-resolve promises immediately to dodge false rejection from - // subsequent errors - if ( depth ) { - process(); - } else { - - // Call an optional hook to record the stack, in case of exception - // since it's otherwise lost when execution goes async - if ( jQuery.Deferred.getStackHook ) { - process.stackTrace = jQuery.Deferred.getStackHook(); - } - window.setTimeout( process ); - } - }; - } - - return jQuery.Deferred( function( newDefer ) { - - // progress_handlers.add( ... ) - tuples[ 0 ][ 3 ].add( - resolve( - 0, - newDefer, - isFunction( onProgress ) ? - onProgress : - Identity, - newDefer.notifyWith - ) - ); - - // fulfilled_handlers.add( ... ) - tuples[ 1 ][ 3 ].add( - resolve( - 0, - newDefer, - isFunction( onFulfilled ) ? - onFulfilled : - Identity - ) - ); - - // rejected_handlers.add( ... ) - tuples[ 2 ][ 3 ].add( - resolve( - 0, - newDefer, - isFunction( onRejected ) ? - onRejected : - Thrower - ) - ); - } ).promise(); - }, - - // Get a promise for this deferred - // If obj is provided, the promise aspect is added to the object - promise: function( obj ) { - return obj != null ? jQuery.extend( obj, promise ) : promise; - } - }, - deferred = {}; - - // Add list-specific methods - jQuery.each( tuples, function( i, tuple ) { - var list = tuple[ 2 ], - stateString = tuple[ 5 ]; - - // promise.progress = list.add - // promise.done = list.add - // promise.fail = list.add - promise[ tuple[ 1 ] ] = list.add; - - // Handle state - if ( stateString ) { - list.add( - function() { - - // state = "resolved" (i.e., fulfilled) - // state = "rejected" - state = stateString; - }, - - // rejected_callbacks.disable - // fulfilled_callbacks.disable - tuples[ 3 - i ][ 2 ].disable, - - // rejected_handlers.disable - // fulfilled_handlers.disable - tuples[ 3 - i ][ 3 ].disable, - - // progress_callbacks.lock - tuples[ 0 ][ 2 ].lock, - - // progress_handlers.lock - tuples[ 0 ][ 3 ].lock - ); - } - - // progress_handlers.fire - // fulfilled_handlers.fire - // rejected_handlers.fire - list.add( tuple[ 3 ].fire ); - - // deferred.notify = function() { deferred.notifyWith(...) } - // deferred.resolve = function() { deferred.resolveWith(...) } - // deferred.reject = function() { deferred.rejectWith(...) } - deferred[ tuple[ 0 ] ] = function() { - deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments ); - return this; - }; - - // deferred.notifyWith = list.fireWith - // deferred.resolveWith = list.fireWith - // deferred.rejectWith = list.fireWith - deferred[ tuple[ 0 ] + "With" ] = list.fireWith; - } ); - - // Make the deferred a promise - promise.promise( deferred ); - - // Call given func if any - if ( func ) { - func.call( deferred, deferred ); - } - - // All done! - return deferred; - }, - - // Deferred helper - when: function( singleValue ) { - var - - // count of uncompleted subordinates - remaining = arguments.length, - - // count of unprocessed arguments - i = remaining, - - // subordinate fulfillment data - resolveContexts = Array( i ), - resolveValues = slice.call( arguments ), - - // the primary Deferred - primary = jQuery.Deferred(), - - // subordinate callback factory - updateFunc = function( i ) { - return function( value ) { - resolveContexts[ i ] = this; - resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; - if ( !( --remaining ) ) { - primary.resolveWith( resolveContexts, resolveValues ); - } - }; - }; - - // Single- and empty arguments are adopted like Promise.resolve - if ( remaining <= 1 ) { - adoptValue( singleValue, primary.done( updateFunc( i ) ).resolve, primary.reject, - !remaining ); - - // Use .then() to unwrap secondary thenables (cf. gh-3000) - if ( primary.state() === "pending" || - isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { - - return primary.then(); - } - } - - // Multiple arguments are aggregated like Promise.all array elements - while ( i-- ) { - adoptValue( resolveValues[ i ], updateFunc( i ), primary.reject ); - } - - return primary.promise(); - } -} ); - - -// These usually indicate a programmer mistake during development, -// warn about them ASAP rather than swallowing them by default. -var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/; - -jQuery.Deferred.exceptionHook = function( error, stack ) { - - // Support: IE 8 - 9 only - // Console exists when dev tools are open, which can happen at any time - if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) { - window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack ); - } -}; - - - - -jQuery.readyException = function( error ) { - window.setTimeout( function() { - throw error; - } ); -}; - - - - -// The deferred used on DOM ready -var readyList = jQuery.Deferred(); - -jQuery.fn.ready = function( fn ) { - - readyList - .then( fn ) - - // Wrap jQuery.readyException in a function so that the lookup - // happens at the time of error handling instead of callback - // registration. - .catch( function( error ) { - jQuery.readyException( error ); - } ); - - return this; -}; - -jQuery.extend( { - - // Is the DOM ready to be used? Set to true once it occurs. - isReady: false, - - // A counter to track how many items to wait for before - // the ready event fires. See #6781 - readyWait: 1, - - // Handle when the DOM is ready - ready: function( wait ) { - - // Abort if there are pending holds or we're already ready - if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { - return; - } - - // Remember that the DOM is ready - jQuery.isReady = true; - - // If a normal DOM Ready event fired, decrement, and wait if need be - if ( wait !== true && --jQuery.readyWait > 0 ) { - return; - } - - // If there are functions bound, to execute - readyList.resolveWith( document, [ jQuery ] ); - } -} ); - -jQuery.ready.then = readyList.then; - -// The ready event handler and self cleanup method -function completed() { - document.removeEventListener( "DOMContentLoaded", completed ); - window.removeEventListener( "load", completed ); - jQuery.ready(); -} - -// Catch cases where $(document).ready() is called -// after the browser event has already occurred. -// Support: IE <=9 - 10 only -// Older IE sometimes signals "interactive" too soon -if ( document.readyState === "complete" || - ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) { - - // Handle it asynchronously to allow scripts the opportunity to delay ready - window.setTimeout( jQuery.ready ); - -} else { - - // Use the handy event callback - document.addEventListener( "DOMContentLoaded", completed ); - - // A fallback to window.onload, that will always work - window.addEventListener( "load", completed ); -} - - - - -// Multifunctional method to get and set values of a collection -// The value/s can optionally be executed if it's a function -var access = function( elems, fn, key, value, chainable, emptyGet, raw ) { - var i = 0, - len = elems.length, - bulk = key == null; - - // Sets many values - if ( toType( key ) === "object" ) { - chainable = true; - for ( i in key ) { - access( elems, fn, i, key[ i ], true, emptyGet, raw ); - } - - // Sets one value - } else if ( value !== undefined ) { - chainable = true; - - if ( !isFunction( value ) ) { - raw = true; - } - - if ( bulk ) { - - // Bulk operations run against the entire set - if ( raw ) { - fn.call( elems, value ); - fn = null; - - // ...except when executing function values - } else { - bulk = fn; - fn = function( elem, _key, value ) { - return bulk.call( jQuery( elem ), value ); - }; - } - } - - if ( fn ) { - for ( ; i < len; i++ ) { - fn( - elems[ i ], key, raw ? - value : - value.call( elems[ i ], i, fn( elems[ i ], key ) ) - ); - } - } - } - - if ( chainable ) { - return elems; - } - - // Gets - if ( bulk ) { - return fn.call( elems ); - } - - return len ? fn( elems[ 0 ], key ) : emptyGet; -}; - - -// Matches dashed string for camelizing -var rmsPrefix = /^-ms-/, - rdashAlpha = /-([a-z])/g; - -// Used by camelCase as callback to replace() -function fcamelCase( _all, letter ) { - return letter.toUpperCase(); -} - -// Convert dashed to camelCase; used by the css and data modules -// Support: IE <=9 - 11, Edge 12 - 15 -// Microsoft forgot to hump their vendor prefix (#9572) -function camelCase( string ) { - return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); -} -var acceptData = function( owner ) { - - // Accepts only: - // - Node - // - Node.ELEMENT_NODE - // - Node.DOCUMENT_NODE - // - Object - // - Any - return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType ); -}; - - - - -function Data() { - this.expando = jQuery.expando + Data.uid++; -} - -Data.uid = 1; - -Data.prototype = { - - cache: function( owner ) { - - // Check if the owner object already has a cache - var value = owner[ this.expando ]; - - // If not, create one - if ( !value ) { - value = {}; - - // We can accept data for non-element nodes in modern browsers, - // but we should not, see #8335. - // Always return an empty object. - if ( acceptData( owner ) ) { - - // If it is a node unlikely to be stringify-ed or looped over - // use plain assignment - if ( owner.nodeType ) { - owner[ this.expando ] = value; - - // Otherwise secure it in a non-enumerable property - // configurable must be true to allow the property to be - // deleted when data is removed - } else { - Object.defineProperty( owner, this.expando, { - value: value, - configurable: true - } ); - } - } - } - - return value; - }, - set: function( owner, data, value ) { - var prop, - cache = this.cache( owner ); - - // Handle: [ owner, key, value ] args - // Always use camelCase key (gh-2257) - if ( typeof data === "string" ) { - cache[ camelCase( data ) ] = value; - - // Handle: [ owner, { properties } ] args - } else { - - // Copy the properties one-by-one to the cache object - for ( prop in data ) { - cache[ camelCase( prop ) ] = data[ prop ]; - } - } - return cache; - }, - get: function( owner, key ) { - return key === undefined ? - this.cache( owner ) : - - // Always use camelCase key (gh-2257) - owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ]; - }, - access: function( owner, key, value ) { - - // In cases where either: - // - // 1. No key was specified - // 2. A string key was specified, but no value provided - // - // Take the "read" path and allow the get method to determine - // which value to return, respectively either: - // - // 1. The entire cache object - // 2. The data stored at the key - // - if ( key === undefined || - ( ( key && typeof key === "string" ) && value === undefined ) ) { - - return this.get( owner, key ); - } - - // When the key is not a string, or both a key and value - // are specified, set or extend (existing objects) with either: - // - // 1. An object of properties - // 2. A key and value - // - this.set( owner, key, value ); - - // Since the "set" path can have two possible entry points - // return the expected data based on which path was taken[*] - return value !== undefined ? value : key; - }, - remove: function( owner, key ) { - var i, - cache = owner[ this.expando ]; - - if ( cache === undefined ) { - return; - } - - if ( key !== undefined ) { - - // Support array or space separated string of keys - if ( Array.isArray( key ) ) { - - // If key is an array of keys... - // We always set camelCase keys, so remove that. - key = key.map( camelCase ); - } else { - key = camelCase( key ); - - // If a key with the spaces exists, use it. - // Otherwise, create an array by matching non-whitespace - key = key in cache ? - [ key ] : - ( key.match( rnothtmlwhite ) || [] ); - } - - i = key.length; - - while ( i-- ) { - delete cache[ key[ i ] ]; - } - } - - // Remove the expando if there's no more data - if ( key === undefined || jQuery.isEmptyObject( cache ) ) { - - // Support: Chrome <=35 - 45 - // Webkit & Blink performance suffers when deleting properties - // from DOM nodes, so set to undefined instead - // https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted) - if ( owner.nodeType ) { - owner[ this.expando ] = undefined; - } else { - delete owner[ this.expando ]; - } - } - }, - hasData: function( owner ) { - var cache = owner[ this.expando ]; - return cache !== undefined && !jQuery.isEmptyObject( cache ); - } -}; -var dataPriv = new Data(); - -var dataUser = new Data(); - - - -// Implementation Summary -// -// 1. Enforce API surface and semantic compatibility with 1.9.x branch -// 2. Improve the module's maintainability by reducing the storage -// paths to a single mechanism. -// 3. Use the same single mechanism to support "private" and "user" data. -// 4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) -// 5. Avoid exposing implementation details on user objects (eg. expando properties) -// 6. Provide a clear path for implementation upgrade to WeakMap in 2014 - -var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, - rmultiDash = /[A-Z]/g; - -function getData( data ) { - if ( data === "true" ) { - return true; - } - - if ( data === "false" ) { - return false; - } - - if ( data === "null" ) { - return null; - } - - // Only convert to a number if it doesn't change the string - if ( data === +data + "" ) { - return +data; - } - - if ( rbrace.test( data ) ) { - return JSON.parse( data ); - } - - return data; -} - -function dataAttr( elem, key, data ) { - var name; - - // If nothing was found internally, try to fetch any - // data from the HTML5 data-* attribute - if ( data === undefined && elem.nodeType === 1 ) { - name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase(); - data = elem.getAttribute( name ); - - if ( typeof data === "string" ) { - try { - data = getData( data ); - } catch ( e ) {} - - // Make sure we set the data so it isn't changed later - dataUser.set( elem, key, data ); - } else { - data = undefined; - } - } - return data; -} - -jQuery.extend( { - hasData: function( elem ) { - return dataUser.hasData( elem ) || dataPriv.hasData( elem ); - }, - - data: function( elem, name, data ) { - return dataUser.access( elem, name, data ); - }, - - removeData: function( elem, name ) { - dataUser.remove( elem, name ); - }, - - // TODO: Now that all calls to _data and _removeData have been replaced - // with direct calls to dataPriv methods, these can be deprecated. - _data: function( elem, name, data ) { - return dataPriv.access( elem, name, data ); - }, - - _removeData: function( elem, name ) { - dataPriv.remove( elem, name ); - } -} ); - -jQuery.fn.extend( { - data: function( key, value ) { - var i, name, data, - elem = this[ 0 ], - attrs = elem && elem.attributes; - - // Gets all values - if ( key === undefined ) { - if ( this.length ) { - data = dataUser.get( elem ); - - if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) { - i = attrs.length; - while ( i-- ) { - - // Support: IE 11 only - // The attrs elements can be null (#14894) - if ( attrs[ i ] ) { - name = attrs[ i ].name; - if ( name.indexOf( "data-" ) === 0 ) { - name = camelCase( name.slice( 5 ) ); - dataAttr( elem, name, data[ name ] ); - } - } - } - dataPriv.set( elem, "hasDataAttrs", true ); - } - } - - return data; - } - - // Sets multiple values - if ( typeof key === "object" ) { - return this.each( function() { - dataUser.set( this, key ); - } ); - } - - return access( this, function( value ) { - var data; - - // The calling jQuery object (element matches) is not empty - // (and therefore has an element appears at this[ 0 ]) and the - // `value` parameter was not undefined. An empty jQuery object - // will result in `undefined` for elem = this[ 0 ] which will - // throw an exception if an attempt to read a data cache is made. - if ( elem && value === undefined ) { - - // Attempt to get data from the cache - // The key will always be camelCased in Data - data = dataUser.get( elem, key ); - if ( data !== undefined ) { - return data; - } - - // Attempt to "discover" the data in - // HTML5 custom data-* attrs - data = dataAttr( elem, key ); - if ( data !== undefined ) { - return data; - } - - // We tried really hard, but the data doesn't exist. - return; - } - - // Set the data... - this.each( function() { - - // We always store the camelCased key - dataUser.set( this, key, value ); - } ); - }, null, value, arguments.length > 1, null, true ); - }, - - removeData: function( key ) { - return this.each( function() { - dataUser.remove( this, key ); - } ); - } -} ); - - -jQuery.extend( { - queue: function( elem, type, data ) { - var queue; - - if ( elem ) { - type = ( type || "fx" ) + "queue"; - queue = dataPriv.get( elem, type ); - - // Speed up dequeue by getting out quickly if this is just a lookup - if ( data ) { - if ( !queue || Array.isArray( data ) ) { - queue = dataPriv.access( elem, type, jQuery.makeArray( data ) ); - } else { - queue.push( data ); - } - } - return queue || []; - } - }, - - dequeue: function( elem, type ) { - type = type || "fx"; - - var queue = jQuery.queue( elem, type ), - startLength = queue.length, - fn = queue.shift(), - hooks = jQuery._queueHooks( elem, type ), - next = function() { - jQuery.dequeue( elem, type ); - }; - - // If the fx queue is dequeued, always remove the progress sentinel - if ( fn === "inprogress" ) { - fn = queue.shift(); - startLength--; - } - - if ( fn ) { - - // Add a progress sentinel to prevent the fx queue from being - // automatically dequeued - if ( type === "fx" ) { - queue.unshift( "inprogress" ); - } - - // Clear up the last queue stop function - delete hooks.stop; - fn.call( elem, next, hooks ); - } - - if ( !startLength && hooks ) { - hooks.empty.fire(); - } - }, - - // Not public - generate a queueHooks object, or return the current one - _queueHooks: function( elem, type ) { - var key = type + "queueHooks"; - return dataPriv.get( elem, key ) || dataPriv.access( elem, key, { - empty: jQuery.Callbacks( "once memory" ).add( function() { - dataPriv.remove( elem, [ type + "queue", key ] ); - } ) - } ); - } -} ); - -jQuery.fn.extend( { - queue: function( type, data ) { - var setter = 2; - - if ( typeof type !== "string" ) { - data = type; - type = "fx"; - setter--; - } - - if ( arguments.length < setter ) { - return jQuery.queue( this[ 0 ], type ); - } - - return data === undefined ? - this : - this.each( function() { - var queue = jQuery.queue( this, type, data ); - - // Ensure a hooks for this queue - jQuery._queueHooks( this, type ); - - if ( type === "fx" && queue[ 0 ] !== "inprogress" ) { - jQuery.dequeue( this, type ); - } - } ); - }, - dequeue: function( type ) { - return this.each( function() { - jQuery.dequeue( this, type ); - } ); - }, - clearQueue: function( type ) { - return this.queue( type || "fx", [] ); - }, - - // Get a promise resolved when queues of a certain type - // are emptied (fx is the type by default) - promise: function( type, obj ) { - var tmp, - count = 1, - defer = jQuery.Deferred(), - elements = this, - i = this.length, - resolve = function() { - if ( !( --count ) ) { - defer.resolveWith( elements, [ elements ] ); - } - }; - - if ( typeof type !== "string" ) { - obj = type; - type = undefined; - } - type = type || "fx"; - - while ( i-- ) { - tmp = dataPriv.get( elements[ i ], type + "queueHooks" ); - if ( tmp && tmp.empty ) { - count++; - tmp.empty.add( resolve ); - } - } - resolve(); - return defer.promise( obj ); - } -} ); -var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source; - -var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ); - - -var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; - -var documentElement = document.documentElement; - - - - var isAttached = function( elem ) { - return jQuery.contains( elem.ownerDocument, elem ); - }, - composed = { composed: true }; - - // Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only - // Check attachment across shadow DOM boundaries when possible (gh-3504) - // Support: iOS 10.0-10.2 only - // Early iOS 10 versions support `attachShadow` but not `getRootNode`, - // leading to errors. We need to check for `getRootNode`. - if ( documentElement.getRootNode ) { - isAttached = function( elem ) { - return jQuery.contains( elem.ownerDocument, elem ) || - elem.getRootNode( composed ) === elem.ownerDocument; - }; - } -var isHiddenWithinTree = function( elem, el ) { - - // isHiddenWithinTree might be called from jQuery#filter function; - // in that case, element will be second argument - elem = el || elem; - - // Inline style trumps all - return elem.style.display === "none" || - elem.style.display === "" && - - // Otherwise, check computed style - // Support: Firefox <=43 - 45 - // Disconnected elements can have computed display: none, so first confirm that elem is - // in the document. - isAttached( elem ) && - - jQuery.css( elem, "display" ) === "none"; - }; - - - -function adjustCSS( elem, prop, valueParts, tween ) { - var adjusted, scale, - maxIterations = 20, - currentValue = tween ? - function() { - return tween.cur(); - } : - function() { - return jQuery.css( elem, prop, "" ); - }, - initial = currentValue(), - unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), - - // Starting value computation is required for potential unit mismatches - initialInUnit = elem.nodeType && - ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) && - rcssNum.exec( jQuery.css( elem, prop ) ); - - if ( initialInUnit && initialInUnit[ 3 ] !== unit ) { - - // Support: Firefox <=54 - // Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144) - initial = initial / 2; - - // Trust units reported by jQuery.css - unit = unit || initialInUnit[ 3 ]; - - // Iteratively approximate from a nonzero starting point - initialInUnit = +initial || 1; - - while ( maxIterations-- ) { - - // Evaluate and update our best guess (doubling guesses that zero out). - // Finish if the scale equals or crosses 1 (making the old*new product non-positive). - jQuery.style( elem, prop, initialInUnit + unit ); - if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) { - maxIterations = 0; - } - initialInUnit = initialInUnit / scale; - - } - - initialInUnit = initialInUnit * 2; - jQuery.style( elem, prop, initialInUnit + unit ); - - // Make sure we update the tween properties later on - valueParts = valueParts || []; - } - - if ( valueParts ) { - initialInUnit = +initialInUnit || +initial || 0; - - // Apply relative offset (+=/-=) if specified - adjusted = valueParts[ 1 ] ? - initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] : - +valueParts[ 2 ]; - if ( tween ) { - tween.unit = unit; - tween.start = initialInUnit; - tween.end = adjusted; - } - } - return adjusted; -} - - -var defaultDisplayMap = {}; - -function getDefaultDisplay( elem ) { - var temp, - doc = elem.ownerDocument, - nodeName = elem.nodeName, - display = defaultDisplayMap[ nodeName ]; - - if ( display ) { - return display; - } - - temp = doc.body.appendChild( doc.createElement( nodeName ) ); - display = jQuery.css( temp, "display" ); - - temp.parentNode.removeChild( temp ); - - if ( display === "none" ) { - display = "block"; - } - defaultDisplayMap[ nodeName ] = display; - - return display; -} - -function showHide( elements, show ) { - var display, elem, - values = [], - index = 0, - length = elements.length; - - // Determine new display value for elements that need to change - for ( ; index < length; index++ ) { - elem = elements[ index ]; - if ( !elem.style ) { - continue; - } - - display = elem.style.display; - if ( show ) { - - // Since we force visibility upon cascade-hidden elements, an immediate (and slow) - // check is required in this first loop unless we have a nonempty display value (either - // inline or about-to-be-restored) - if ( display === "none" ) { - values[ index ] = dataPriv.get( elem, "display" ) || null; - if ( !values[ index ] ) { - elem.style.display = ""; - } - } - if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) { - values[ index ] = getDefaultDisplay( elem ); - } - } else { - if ( display !== "none" ) { - values[ index ] = "none"; - - // Remember what we're overwriting - dataPriv.set( elem, "display", display ); - } - } - } - - // Set the display of the elements in a second loop to avoid constant reflow - for ( index = 0; index < length; index++ ) { - if ( values[ index ] != null ) { - elements[ index ].style.display = values[ index ]; - } - } - - return elements; -} - -jQuery.fn.extend( { - show: function() { - return showHide( this, true ); - }, - hide: function() { - return showHide( this ); - }, - toggle: function( state ) { - if ( typeof state === "boolean" ) { - return state ? this.show() : this.hide(); - } - - return this.each( function() { - if ( isHiddenWithinTree( this ) ) { - jQuery( this ).show(); - } else { - jQuery( this ).hide(); - } - } ); - } -} ); -var rcheckableType = ( /^(?:checkbox|radio)$/i ); - -var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]*)/i ); - -var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i ); - - - -( function() { - var fragment = document.createDocumentFragment(), - div = fragment.appendChild( document.createElement( "div" ) ), - input = document.createElement( "input" ); - - // Support: Android 4.0 - 4.3 only - // Check state lost if the name is set (#11217) - // Support: Windows Web Apps (WWA) - // `name` and `type` must use .setAttribute for WWA (#14901) - input.setAttribute( "type", "radio" ); - input.setAttribute( "checked", "checked" ); - input.setAttribute( "name", "t" ); - - div.appendChild( input ); - - // Support: Android <=4.1 only - // Older WebKit doesn't clone checked state correctly in fragments - support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; - - // Support: IE <=11 only - // Make sure textarea (and checkbox) defaultValue is properly cloned - div.innerHTML = ""; - support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; - - // Support: IE <=9 only - // IE <=9 replaces "; - support.option = !!div.lastChild; -} )(); - - -// We have to close these tags to support XHTML (#13200) -var wrapMap = { - - // XHTML parsers do not magically insert elements in the - // same way that tag soup parsers do. So we cannot shorten - // this by omitting or other required elements. - thead: [ 1, "", "
" ], - col: [ 2, "", "
" ], - tr: [ 2, "", "
" ], - td: [ 3, "", "
" ], - - _default: [ 0, "", "" ] -}; - -wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; -wrapMap.th = wrapMap.td; - -// Support: IE <=9 only -if ( !support.option ) { - wrapMap.optgroup = wrapMap.option = [ 1, "" ]; -} - - -function getAll( context, tag ) { - - // Support: IE <=9 - 11 only - // Use typeof to avoid zero-argument method invocation on host objects (#15151) - var ret; - - if ( typeof context.getElementsByTagName !== "undefined" ) { - ret = context.getElementsByTagName( tag || "*" ); - - } else if ( typeof context.querySelectorAll !== "undefined" ) { - ret = context.querySelectorAll( tag || "*" ); - - } else { - ret = []; - } - - if ( tag === undefined || tag && nodeName( context, tag ) ) { - return jQuery.merge( [ context ], ret ); - } - - return ret; -} - - -// Mark scripts as having already been evaluated -function setGlobalEval( elems, refElements ) { - var i = 0, - l = elems.length; - - for ( ; i < l; i++ ) { - dataPriv.set( - elems[ i ], - "globalEval", - !refElements || dataPriv.get( refElements[ i ], "globalEval" ) - ); - } -} - - -var rhtml = /<|&#?\w+;/; - -function buildFragment( elems, context, scripts, selection, ignored ) { - var elem, tmp, tag, wrap, attached, j, - fragment = context.createDocumentFragment(), - nodes = [], - i = 0, - l = elems.length; - - for ( ; i < l; i++ ) { - elem = elems[ i ]; - - if ( elem || elem === 0 ) { - - // Add nodes directly - if ( toType( elem ) === "object" ) { - - // Support: Android <=4.0 only, PhantomJS 1 only - // push.apply(_, arraylike) throws on ancient WebKit - jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); - - // Convert non-html into a text node - } else if ( !rhtml.test( elem ) ) { - nodes.push( context.createTextNode( elem ) ); - - // Convert html into DOM nodes - } else { - tmp = tmp || fragment.appendChild( context.createElement( "div" ) ); - - // Deserialize a standard representation - tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase(); - wrap = wrapMap[ tag ] || wrapMap._default; - tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ]; - - // Descend through wrappers to the right content - j = wrap[ 0 ]; - while ( j-- ) { - tmp = tmp.lastChild; - } - - // Support: Android <=4.0 only, PhantomJS 1 only - // push.apply(_, arraylike) throws on ancient WebKit - jQuery.merge( nodes, tmp.childNodes ); - - // Remember the top-level container - tmp = fragment.firstChild; - - // Ensure the created nodes are orphaned (#12392) - tmp.textContent = ""; - } - } - } - - // Remove wrapper from fragment - fragment.textContent = ""; - - i = 0; - while ( ( elem = nodes[ i++ ] ) ) { - - // Skip elements already in the context collection (trac-4087) - if ( selection && jQuery.inArray( elem, selection ) > -1 ) { - if ( ignored ) { - ignored.push( elem ); - } - continue; - } - - attached = isAttached( elem ); - - // Append to fragment - tmp = getAll( fragment.appendChild( elem ), "script" ); - - // Preserve script evaluation history - if ( attached ) { - setGlobalEval( tmp ); - } - - // Capture executables - if ( scripts ) { - j = 0; - while ( ( elem = tmp[ j++ ] ) ) { - if ( rscriptType.test( elem.type || "" ) ) { - scripts.push( elem ); - } - } - } - } - - return fragment; -} - - -var rtypenamespace = /^([^.]*)(?:\.(.+)|)/; - -function returnTrue() { - return true; -} - -function returnFalse() { - return false; -} - -// Support: IE <=9 - 11+ -// focus() and blur() are asynchronous, except when they are no-op. -// So expect focus to be synchronous when the element is already active, -// and blur to be synchronous when the element is not already active. -// (focus and blur are always synchronous in other supported browsers, -// this just defines when we can count on it). -function expectSync( elem, type ) { - return ( elem === safeActiveElement() ) === ( type === "focus" ); -} - -// Support: IE <=9 only -// Accessing document.activeElement can throw unexpectedly -// https://bugs.jquery.com/ticket/13393 -function safeActiveElement() { - try { - return document.activeElement; - } catch ( err ) { } -} - -function on( elem, types, selector, data, fn, one ) { - var origFn, type; - - // Types can be a map of types/handlers - if ( typeof types === "object" ) { - - // ( types-Object, selector, data ) - if ( typeof selector !== "string" ) { - - // ( types-Object, data ) - data = data || selector; - selector = undefined; - } - for ( type in types ) { - on( elem, type, selector, data, types[ type ], one ); - } - return elem; - } - - if ( data == null && fn == null ) { - - // ( types, fn ) - fn = selector; - data = selector = undefined; - } else if ( fn == null ) { - if ( typeof selector === "string" ) { - - // ( types, selector, fn ) - fn = data; - data = undefined; - } else { - - // ( types, data, fn ) - fn = data; - data = selector; - selector = undefined; - } - } - if ( fn === false ) { - fn = returnFalse; - } else if ( !fn ) { - return elem; - } - - if ( one === 1 ) { - origFn = fn; - fn = function( event ) { - - // Can use an empty set, since event contains the info - jQuery().off( event ); - return origFn.apply( this, arguments ); - }; - - // Use same guid so caller can remove using origFn - fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); - } - return elem.each( function() { - jQuery.event.add( this, types, fn, data, selector ); - } ); -} - -/* - * Helper functions for managing events -- not part of the public interface. - * Props to Dean Edwards' addEvent library for many of the ideas. - */ -jQuery.event = { - - global: {}, - - add: function( elem, types, handler, data, selector ) { - - var handleObjIn, eventHandle, tmp, - events, t, handleObj, - special, handlers, type, namespaces, origType, - elemData = dataPriv.get( elem ); - - // Only attach events to objects that accept data - if ( !acceptData( elem ) ) { - return; - } - - // Caller can pass in an object of custom data in lieu of the handler - if ( handler.handler ) { - handleObjIn = handler; - handler = handleObjIn.handler; - selector = handleObjIn.selector; - } - - // Ensure that invalid selectors throw exceptions at attach time - // Evaluate against documentElement in case elem is a non-element node (e.g., document) - if ( selector ) { - jQuery.find.matchesSelector( documentElement, selector ); - } - - // Make sure that the handler has a unique ID, used to find/remove it later - if ( !handler.guid ) { - handler.guid = jQuery.guid++; - } - - // Init the element's event structure and main handler, if this is the first - if ( !( events = elemData.events ) ) { - events = elemData.events = Object.create( null ); - } - if ( !( eventHandle = elemData.handle ) ) { - eventHandle = elemData.handle = function( e ) { - - // Discard the second event of a jQuery.event.trigger() and - // when an event is called after a page has unloaded - return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ? - jQuery.event.dispatch.apply( elem, arguments ) : undefined; - }; - } - - // Handle multiple events separated by a space - types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; - t = types.length; - while ( t-- ) { - tmp = rtypenamespace.exec( types[ t ] ) || []; - type = origType = tmp[ 1 ]; - namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); - - // There *must* be a type, no attaching namespace-only handlers - if ( !type ) { - continue; - } - - // If event changes its type, use the special event handlers for the changed type - special = jQuery.event.special[ type ] || {}; - - // If selector defined, determine special event api type, otherwise given type - type = ( selector ? special.delegateType : special.bindType ) || type; - - // Update special based on newly reset type - special = jQuery.event.special[ type ] || {}; - - // handleObj is passed to all event handlers - handleObj = jQuery.extend( { - type: type, - origType: origType, - data: data, - handler: handler, - guid: handler.guid, - selector: selector, - needsContext: selector && jQuery.expr.match.needsContext.test( selector ), - namespace: namespaces.join( "." ) - }, handleObjIn ); - - // Init the event handler queue if we're the first - if ( !( handlers = events[ type ] ) ) { - handlers = events[ type ] = []; - handlers.delegateCount = 0; - - // Only use addEventListener if the special events handler returns false - if ( !special.setup || - special.setup.call( elem, data, namespaces, eventHandle ) === false ) { - - if ( elem.addEventListener ) { - elem.addEventListener( type, eventHandle ); - } - } - } - - if ( special.add ) { - special.add.call( elem, handleObj ); - - if ( !handleObj.handler.guid ) { - handleObj.handler.guid = handler.guid; - } - } - - // Add to the element's handler list, delegates in front - if ( selector ) { - handlers.splice( handlers.delegateCount++, 0, handleObj ); - } else { - handlers.push( handleObj ); - } - - // Keep track of which events have ever been used, for event optimization - jQuery.event.global[ type ] = true; - } - - }, - - // Detach an event or set of events from an element - remove: function( elem, types, handler, selector, mappedTypes ) { - - var j, origCount, tmp, - events, t, handleObj, - special, handlers, type, namespaces, origType, - elemData = dataPriv.hasData( elem ) && dataPriv.get( elem ); - - if ( !elemData || !( events = elemData.events ) ) { - return; - } - - // Once for each type.namespace in types; type may be omitted - types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; - t = types.length; - while ( t-- ) { - tmp = rtypenamespace.exec( types[ t ] ) || []; - type = origType = tmp[ 1 ]; - namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); - - // Unbind all events (on this namespace, if provided) for the element - if ( !type ) { - for ( type in events ) { - jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); - } - continue; - } - - special = jQuery.event.special[ type ] || {}; - type = ( selector ? special.delegateType : special.bindType ) || type; - handlers = events[ type ] || []; - tmp = tmp[ 2 ] && - new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ); - - // Remove matching events - origCount = j = handlers.length; - while ( j-- ) { - handleObj = handlers[ j ]; - - if ( ( mappedTypes || origType === handleObj.origType ) && - ( !handler || handler.guid === handleObj.guid ) && - ( !tmp || tmp.test( handleObj.namespace ) ) && - ( !selector || selector === handleObj.selector || - selector === "**" && handleObj.selector ) ) { - handlers.splice( j, 1 ); - - if ( handleObj.selector ) { - handlers.delegateCount--; - } - if ( special.remove ) { - special.remove.call( elem, handleObj ); - } - } - } - - // Remove generic event handler if we removed something and no more handlers exist - // (avoids potential for endless recursion during removal of special event handlers) - if ( origCount && !handlers.length ) { - if ( !special.teardown || - special.teardown.call( elem, namespaces, elemData.handle ) === false ) { - - jQuery.removeEvent( elem, type, elemData.handle ); - } - - delete events[ type ]; - } - } - - // Remove data and the expando if it's no longer used - if ( jQuery.isEmptyObject( events ) ) { - dataPriv.remove( elem, "handle events" ); - } - }, - - dispatch: function( nativeEvent ) { - - var i, j, ret, matched, handleObj, handlerQueue, - args = new Array( arguments.length ), - - // Make a writable jQuery.Event from the native event object - event = jQuery.event.fix( nativeEvent ), - - handlers = ( - dataPriv.get( this, "events" ) || Object.create( null ) - )[ event.type ] || [], - special = jQuery.event.special[ event.type ] || {}; - - // Use the fix-ed jQuery.Event rather than the (read-only) native event - args[ 0 ] = event; - - for ( i = 1; i < arguments.length; i++ ) { - args[ i ] = arguments[ i ]; - } - - event.delegateTarget = this; - - // Call the preDispatch hook for the mapped type, and let it bail if desired - if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { - return; - } - - // Determine handlers - handlerQueue = jQuery.event.handlers.call( this, event, handlers ); - - // Run delegates first; they may want to stop propagation beneath us - i = 0; - while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) { - event.currentTarget = matched.elem; - - j = 0; - while ( ( handleObj = matched.handlers[ j++ ] ) && - !event.isImmediatePropagationStopped() ) { - - // If the event is namespaced, then each handler is only invoked if it is - // specially universal or its namespaces are a superset of the event's. - if ( !event.rnamespace || handleObj.namespace === false || - event.rnamespace.test( handleObj.namespace ) ) { - - event.handleObj = handleObj; - event.data = handleObj.data; - - ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle || - handleObj.handler ).apply( matched.elem, args ); - - if ( ret !== undefined ) { - if ( ( event.result = ret ) === false ) { - event.preventDefault(); - event.stopPropagation(); - } - } - } - } - } - - // Call the postDispatch hook for the mapped type - if ( special.postDispatch ) { - special.postDispatch.call( this, event ); - } - - return event.result; - }, - - handlers: function( event, handlers ) { - var i, handleObj, sel, matchedHandlers, matchedSelectors, - handlerQueue = [], - delegateCount = handlers.delegateCount, - cur = event.target; - - // Find delegate handlers - if ( delegateCount && - - // Support: IE <=9 - // Black-hole SVG instance trees (trac-13180) - cur.nodeType && - - // Support: Firefox <=42 - // Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861) - // https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click - // Support: IE 11 only - // ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343) - !( event.type === "click" && event.button >= 1 ) ) { - - for ( ; cur !== this; cur = cur.parentNode || this ) { - - // Don't check non-elements (#13208) - // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) - if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) { - matchedHandlers = []; - matchedSelectors = {}; - for ( i = 0; i < delegateCount; i++ ) { - handleObj = handlers[ i ]; - - // Don't conflict with Object.prototype properties (#13203) - sel = handleObj.selector + " "; - - if ( matchedSelectors[ sel ] === undefined ) { - matchedSelectors[ sel ] = handleObj.needsContext ? - jQuery( sel, this ).index( cur ) > -1 : - jQuery.find( sel, this, null, [ cur ] ).length; - } - if ( matchedSelectors[ sel ] ) { - matchedHandlers.push( handleObj ); - } - } - if ( matchedHandlers.length ) { - handlerQueue.push( { elem: cur, handlers: matchedHandlers } ); - } - } - } - } - - // Add the remaining (directly-bound) handlers - cur = this; - if ( delegateCount < handlers.length ) { - handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } ); - } - - return handlerQueue; - }, - - addProp: function( name, hook ) { - Object.defineProperty( jQuery.Event.prototype, name, { - enumerable: true, - configurable: true, - - get: isFunction( hook ) ? - function() { - if ( this.originalEvent ) { - return hook( this.originalEvent ); - } - } : - function() { - if ( this.originalEvent ) { - return this.originalEvent[ name ]; - } - }, - - set: function( value ) { - Object.defineProperty( this, name, { - enumerable: true, - configurable: true, - writable: true, - value: value - } ); - } - } ); - }, - - fix: function( originalEvent ) { - return originalEvent[ jQuery.expando ] ? - originalEvent : - new jQuery.Event( originalEvent ); - }, - - special: { - load: { - - // Prevent triggered image.load events from bubbling to window.load - noBubble: true - }, - click: { - - // Utilize native event to ensure correct state for checkable inputs - setup: function( data ) { - - // For mutual compressibility with _default, replace `this` access with a local var. - // `|| data` is dead code meant only to preserve the variable through minification. - var el = this || data; - - // Claim the first handler - if ( rcheckableType.test( el.type ) && - el.click && nodeName( el, "input" ) ) { - - // dataPriv.set( el, "click", ... ) - leverageNative( el, "click", returnTrue ); - } - - // Return false to allow normal processing in the caller - return false; - }, - trigger: function( data ) { - - // For mutual compressibility with _default, replace `this` access with a local var. - // `|| data` is dead code meant only to preserve the variable through minification. - var el = this || data; - - // Force setup before triggering a click - if ( rcheckableType.test( el.type ) && - el.click && nodeName( el, "input" ) ) { - - leverageNative( el, "click" ); - } - - // Return non-false to allow normal event-path propagation - return true; - }, - - // For cross-browser consistency, suppress native .click() on links - // Also prevent it if we're currently inside a leveraged native-event stack - _default: function( event ) { - var target = event.target; - return rcheckableType.test( target.type ) && - target.click && nodeName( target, "input" ) && - dataPriv.get( target, "click" ) || - nodeName( target, "a" ); - } - }, - - beforeunload: { - postDispatch: function( event ) { - - // Support: Firefox 20+ - // Firefox doesn't alert if the returnValue field is not set. - if ( event.result !== undefined && event.originalEvent ) { - event.originalEvent.returnValue = event.result; - } - } - } - } -}; - -// Ensure the presence of an event listener that handles manually-triggered -// synthetic events by interrupting progress until reinvoked in response to -// *native* events that it fires directly, ensuring that state changes have -// already occurred before other listeners are invoked. -function leverageNative( el, type, expectSync ) { - - // Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add - if ( !expectSync ) { - if ( dataPriv.get( el, type ) === undefined ) { - jQuery.event.add( el, type, returnTrue ); - } - return; - } - - // Register the controller as a special universal handler for all event namespaces - dataPriv.set( el, type, false ); - jQuery.event.add( el, type, { - namespace: false, - handler: function( event ) { - var notAsync, result, - saved = dataPriv.get( this, type ); - - if ( ( event.isTrigger & 1 ) && this[ type ] ) { - - // Interrupt processing of the outer synthetic .trigger()ed event - // Saved data should be false in such cases, but might be a leftover capture object - // from an async native handler (gh-4350) - if ( !saved.length ) { - - // Store arguments for use when handling the inner native event - // There will always be at least one argument (an event object), so this array - // will not be confused with a leftover capture object. - saved = slice.call( arguments ); - dataPriv.set( this, type, saved ); - - // Trigger the native event and capture its result - // Support: IE <=9 - 11+ - // focus() and blur() are asynchronous - notAsync = expectSync( this, type ); - this[ type ](); - result = dataPriv.get( this, type ); - if ( saved !== result || notAsync ) { - dataPriv.set( this, type, false ); - } else { - result = {}; - } - if ( saved !== result ) { - - // Cancel the outer synthetic event - event.stopImmediatePropagation(); - event.preventDefault(); - - // Support: Chrome 86+ - // In Chrome, if an element having a focusout handler is blurred by - // clicking outside of it, it invokes the handler synchronously. If - // that handler calls `.remove()` on the element, the data is cleared, - // leaving `result` undefined. We need to guard against this. - return result && result.value; - } - - // If this is an inner synthetic event for an event with a bubbling surrogate - // (focus or blur), assume that the surrogate already propagated from triggering the - // native event and prevent that from happening again here. - // This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the - // bubbling surrogate propagates *after* the non-bubbling base), but that seems - // less bad than duplication. - } else if ( ( jQuery.event.special[ type ] || {} ).delegateType ) { - event.stopPropagation(); - } - - // If this is a native event triggered above, everything is now in order - // Fire an inner synthetic event with the original arguments - } else if ( saved.length ) { - - // ...and capture the result - dataPriv.set( this, type, { - value: jQuery.event.trigger( - - // Support: IE <=9 - 11+ - // Extend with the prototype to reset the above stopImmediatePropagation() - jQuery.extend( saved[ 0 ], jQuery.Event.prototype ), - saved.slice( 1 ), - this - ) - } ); - - // Abort handling of the native event - event.stopImmediatePropagation(); - } - } - } ); -} - -jQuery.removeEvent = function( elem, type, handle ) { - - // This "if" is needed for plain objects - if ( elem.removeEventListener ) { - elem.removeEventListener( type, handle ); - } -}; - -jQuery.Event = function( src, props ) { - - // Allow instantiation without the 'new' keyword - if ( !( this instanceof jQuery.Event ) ) { - return new jQuery.Event( src, props ); - } - - // Event object - if ( src && src.type ) { - this.originalEvent = src; - this.type = src.type; - - // Events bubbling up the document may have been marked as prevented - // by a handler lower down the tree; reflect the correct value. - this.isDefaultPrevented = src.defaultPrevented || - src.defaultPrevented === undefined && - - // Support: Android <=2.3 only - src.returnValue === false ? - returnTrue : - returnFalse; - - // Create target properties - // Support: Safari <=6 - 7 only - // Target should not be a text node (#504, #13143) - this.target = ( src.target && src.target.nodeType === 3 ) ? - src.target.parentNode : - src.target; - - this.currentTarget = src.currentTarget; - this.relatedTarget = src.relatedTarget; - - // Event type - } else { - this.type = src; - } - - // Put explicitly provided properties onto the event object - if ( props ) { - jQuery.extend( this, props ); - } - - // Create a timestamp if incoming event doesn't have one - this.timeStamp = src && src.timeStamp || Date.now(); - - // Mark it as fixed - this[ jQuery.expando ] = true; -}; - -// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding -// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html -jQuery.Event.prototype = { - constructor: jQuery.Event, - isDefaultPrevented: returnFalse, - isPropagationStopped: returnFalse, - isImmediatePropagationStopped: returnFalse, - isSimulated: false, - - preventDefault: function() { - var e = this.originalEvent; - - this.isDefaultPrevented = returnTrue; - - if ( e && !this.isSimulated ) { - e.preventDefault(); - } - }, - stopPropagation: function() { - var e = this.originalEvent; - - this.isPropagationStopped = returnTrue; - - if ( e && !this.isSimulated ) { - e.stopPropagation(); - } - }, - stopImmediatePropagation: function() { - var e = this.originalEvent; - - this.isImmediatePropagationStopped = returnTrue; - - if ( e && !this.isSimulated ) { - e.stopImmediatePropagation(); - } - - this.stopPropagation(); - } -}; - -// Includes all common event props including KeyEvent and MouseEvent specific props -jQuery.each( { - altKey: true, - bubbles: true, - cancelable: true, - changedTouches: true, - ctrlKey: true, - detail: true, - eventPhase: true, - metaKey: true, - pageX: true, - pageY: true, - shiftKey: true, - view: true, - "char": true, - code: true, - charCode: true, - key: true, - keyCode: true, - button: true, - buttons: true, - clientX: true, - clientY: true, - offsetX: true, - offsetY: true, - pointerId: true, - pointerType: true, - screenX: true, - screenY: true, - targetTouches: true, - toElement: true, - touches: true, - which: true -}, jQuery.event.addProp ); - -jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) { - jQuery.event.special[ type ] = { - - // Utilize native event if possible so blur/focus sequence is correct - setup: function() { - - // Claim the first handler - // dataPriv.set( this, "focus", ... ) - // dataPriv.set( this, "blur", ... ) - leverageNative( this, type, expectSync ); - - // Return false to allow normal processing in the caller - return false; - }, - trigger: function() { - - // Force setup before trigger - leverageNative( this, type ); - - // Return non-false to allow normal event-path propagation - return true; - }, - - // Suppress native focus or blur as it's already being fired - // in leverageNative. - _default: function() { - return true; - }, - - delegateType: delegateType - }; -} ); - -// Create mouseenter/leave events using mouseover/out and event-time checks -// so that event delegation works in jQuery. -// Do the same for pointerenter/pointerleave and pointerover/pointerout -// -// Support: Safari 7 only -// Safari sends mouseenter too often; see: -// https://bugs.chromium.org/p/chromium/issues/detail?id=470258 -// for the description of the bug (it existed in older Chrome versions as well). -jQuery.each( { - mouseenter: "mouseover", - mouseleave: "mouseout", - pointerenter: "pointerover", - pointerleave: "pointerout" -}, function( orig, fix ) { - jQuery.event.special[ orig ] = { - delegateType: fix, - bindType: fix, - - handle: function( event ) { - var ret, - target = this, - related = event.relatedTarget, - handleObj = event.handleObj; - - // For mouseenter/leave call the handler if related is outside the target. - // NB: No relatedTarget if the mouse left/entered the browser window - if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) { - event.type = handleObj.origType; - ret = handleObj.handler.apply( this, arguments ); - event.type = fix; - } - return ret; - } - }; -} ); - -jQuery.fn.extend( { - - on: function( types, selector, data, fn ) { - return on( this, types, selector, data, fn ); - }, - one: function( types, selector, data, fn ) { - return on( this, types, selector, data, fn, 1 ); - }, - off: function( types, selector, fn ) { - var handleObj, type; - if ( types && types.preventDefault && types.handleObj ) { - - // ( event ) dispatched jQuery.Event - handleObj = types.handleObj; - jQuery( types.delegateTarget ).off( - handleObj.namespace ? - handleObj.origType + "." + handleObj.namespace : - handleObj.origType, - handleObj.selector, - handleObj.handler - ); - return this; - } - if ( typeof types === "object" ) { - - // ( types-object [, selector] ) - for ( type in types ) { - this.off( type, selector, types[ type ] ); - } - return this; - } - if ( selector === false || typeof selector === "function" ) { - - // ( types [, fn] ) - fn = selector; - selector = undefined; - } - if ( fn === false ) { - fn = returnFalse; - } - return this.each( function() { - jQuery.event.remove( this, types, fn, selector ); - } ); - } -} ); - - -var - - // Support: IE <=10 - 11, Edge 12 - 13 only - // In IE/Edge using regex groups here causes severe slowdowns. - // See https://connect.microsoft.com/IE/feedback/details/1736512/ - rnoInnerhtml = /\s*$/g; - -// Prefer a tbody over its parent table for containing new rows -function manipulationTarget( elem, content ) { - if ( nodeName( elem, "table" ) && - nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) { - - return jQuery( elem ).children( "tbody" )[ 0 ] || elem; - } - - return elem; -} - -// Replace/restore the type attribute of script elements for safe DOM manipulation -function disableScript( elem ) { - elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type; - return elem; -} -function restoreScript( elem ) { - if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) { - elem.type = elem.type.slice( 5 ); - } else { - elem.removeAttribute( "type" ); - } - - return elem; -} - -function cloneCopyEvent( src, dest ) { - var i, l, type, pdataOld, udataOld, udataCur, events; - - if ( dest.nodeType !== 1 ) { - return; - } - - // 1. Copy private data: events, handlers, etc. - if ( dataPriv.hasData( src ) ) { - pdataOld = dataPriv.get( src ); - events = pdataOld.events; - - if ( events ) { - dataPriv.remove( dest, "handle events" ); - - for ( type in events ) { - for ( i = 0, l = events[ type ].length; i < l; i++ ) { - jQuery.event.add( dest, type, events[ type ][ i ] ); - } - } - } - } - - // 2. Copy user data - if ( dataUser.hasData( src ) ) { - udataOld = dataUser.access( src ); - udataCur = jQuery.extend( {}, udataOld ); - - dataUser.set( dest, udataCur ); - } -} - -// Fix IE bugs, see support tests -function fixInput( src, dest ) { - var nodeName = dest.nodeName.toLowerCase(); - - // Fails to persist the checked state of a cloned checkbox or radio button. - if ( nodeName === "input" && rcheckableType.test( src.type ) ) { - dest.checked = src.checked; - - // Fails to return the selected option to the default selected state when cloning options - } else if ( nodeName === "input" || nodeName === "textarea" ) { - dest.defaultValue = src.defaultValue; - } -} - -function domManip( collection, args, callback, ignored ) { - - // Flatten any nested arrays - args = flat( args ); - - var fragment, first, scripts, hasScripts, node, doc, - i = 0, - l = collection.length, - iNoClone = l - 1, - value = args[ 0 ], - valueIsFunction = isFunction( value ); - - // We can't cloneNode fragments that contain checked, in WebKit - if ( valueIsFunction || - ( l > 1 && typeof value === "string" && - !support.checkClone && rchecked.test( value ) ) ) { - return collection.each( function( index ) { - var self = collection.eq( index ); - if ( valueIsFunction ) { - args[ 0 ] = value.call( this, index, self.html() ); - } - domManip( self, args, callback, ignored ); - } ); - } - - if ( l ) { - fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored ); - first = fragment.firstChild; - - if ( fragment.childNodes.length === 1 ) { - fragment = first; - } - - // Require either new content or an interest in ignored elements to invoke the callback - if ( first || ignored ) { - scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); - hasScripts = scripts.length; - - // Use the original fragment for the last item - // instead of the first because it can end up - // being emptied incorrectly in certain situations (#8070). - for ( ; i < l; i++ ) { - node = fragment; - - if ( i !== iNoClone ) { - node = jQuery.clone( node, true, true ); - - // Keep references to cloned scripts for later restoration - if ( hasScripts ) { - - // Support: Android <=4.0 only, PhantomJS 1 only - // push.apply(_, arraylike) throws on ancient WebKit - jQuery.merge( scripts, getAll( node, "script" ) ); - } - } - - callback.call( collection[ i ], node, i ); - } - - if ( hasScripts ) { - doc = scripts[ scripts.length - 1 ].ownerDocument; - - // Reenable scripts - jQuery.map( scripts, restoreScript ); - - // Evaluate executable scripts on first document insertion - for ( i = 0; i < hasScripts; i++ ) { - node = scripts[ i ]; - if ( rscriptType.test( node.type || "" ) && - !dataPriv.access( node, "globalEval" ) && - jQuery.contains( doc, node ) ) { - - if ( node.src && ( node.type || "" ).toLowerCase() !== "module" ) { - - // Optional AJAX dependency, but won't run scripts if not present - if ( jQuery._evalUrl && !node.noModule ) { - jQuery._evalUrl( node.src, { - nonce: node.nonce || node.getAttribute( "nonce" ) - }, doc ); - } - } else { - DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc ); - } - } - } - } - } - } - - return collection; -} - -function remove( elem, selector, keepData ) { - var node, - nodes = selector ? jQuery.filter( selector, elem ) : elem, - i = 0; - - for ( ; ( node = nodes[ i ] ) != null; i++ ) { - if ( !keepData && node.nodeType === 1 ) { - jQuery.cleanData( getAll( node ) ); - } - - if ( node.parentNode ) { - if ( keepData && isAttached( node ) ) { - setGlobalEval( getAll( node, "script" ) ); - } - node.parentNode.removeChild( node ); - } - } - - return elem; -} - -jQuery.extend( { - htmlPrefilter: function( html ) { - return html; - }, - - clone: function( elem, dataAndEvents, deepDataAndEvents ) { - var i, l, srcElements, destElements, - clone = elem.cloneNode( true ), - inPage = isAttached( elem ); - - // Fix IE cloning issues - if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && - !jQuery.isXMLDoc( elem ) ) { - - // We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2 - destElements = getAll( clone ); - srcElements = getAll( elem ); - - for ( i = 0, l = srcElements.length; i < l; i++ ) { - fixInput( srcElements[ i ], destElements[ i ] ); - } - } - - // Copy the events from the original to the clone - if ( dataAndEvents ) { - if ( deepDataAndEvents ) { - srcElements = srcElements || getAll( elem ); - destElements = destElements || getAll( clone ); - - for ( i = 0, l = srcElements.length; i < l; i++ ) { - cloneCopyEvent( srcElements[ i ], destElements[ i ] ); - } - } else { - cloneCopyEvent( elem, clone ); - } - } - - // Preserve script evaluation history - destElements = getAll( clone, "script" ); - if ( destElements.length > 0 ) { - setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); - } - - // Return the cloned set - return clone; - }, - - cleanData: function( elems ) { - var data, elem, type, - special = jQuery.event.special, - i = 0; - - for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) { - if ( acceptData( elem ) ) { - if ( ( data = elem[ dataPriv.expando ] ) ) { - if ( data.events ) { - for ( type in data.events ) { - if ( special[ type ] ) { - jQuery.event.remove( elem, type ); - - // This is a shortcut to avoid jQuery.event.remove's overhead - } else { - jQuery.removeEvent( elem, type, data.handle ); - } - } - } - - // Support: Chrome <=35 - 45+ - // Assign undefined instead of using delete, see Data#remove - elem[ dataPriv.expando ] = undefined; - } - if ( elem[ dataUser.expando ] ) { - - // Support: Chrome <=35 - 45+ - // Assign undefined instead of using delete, see Data#remove - elem[ dataUser.expando ] = undefined; - } - } - } - } -} ); - -jQuery.fn.extend( { - detach: function( selector ) { - return remove( this, selector, true ); - }, - - remove: function( selector ) { - return remove( this, selector ); - }, - - text: function( value ) { - return access( this, function( value ) { - return value === undefined ? - jQuery.text( this ) : - this.empty().each( function() { - if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { - this.textContent = value; - } - } ); - }, null, value, arguments.length ); - }, - - append: function() { - return domManip( this, arguments, function( elem ) { - if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { - var target = manipulationTarget( this, elem ); - target.appendChild( elem ); - } - } ); - }, - - prepend: function() { - return domManip( this, arguments, function( elem ) { - if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { - var target = manipulationTarget( this, elem ); - target.insertBefore( elem, target.firstChild ); - } - } ); - }, - - before: function() { - return domManip( this, arguments, function( elem ) { - if ( this.parentNode ) { - this.parentNode.insertBefore( elem, this ); - } - } ); - }, - - after: function() { - return domManip( this, arguments, function( elem ) { - if ( this.parentNode ) { - this.parentNode.insertBefore( elem, this.nextSibling ); - } - } ); - }, - - empty: function() { - var elem, - i = 0; - - for ( ; ( elem = this[ i ] ) != null; i++ ) { - if ( elem.nodeType === 1 ) { - - // Prevent memory leaks - jQuery.cleanData( getAll( elem, false ) ); - - // Remove any remaining nodes - elem.textContent = ""; - } - } - - return this; - }, - - clone: function( dataAndEvents, deepDataAndEvents ) { - dataAndEvents = dataAndEvents == null ? false : dataAndEvents; - deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; - - return this.map( function() { - return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); - } ); - }, - - html: function( value ) { - return access( this, function( value ) { - var elem = this[ 0 ] || {}, - i = 0, - l = this.length; - - if ( value === undefined && elem.nodeType === 1 ) { - return elem.innerHTML; - } - - // See if we can take a shortcut and just use innerHTML - if ( typeof value === "string" && !rnoInnerhtml.test( value ) && - !wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { - - value = jQuery.htmlPrefilter( value ); - - try { - for ( ; i < l; i++ ) { - elem = this[ i ] || {}; - - // Remove element nodes and prevent memory leaks - if ( elem.nodeType === 1 ) { - jQuery.cleanData( getAll( elem, false ) ); - elem.innerHTML = value; - } - } - - elem = 0; - - // If using innerHTML throws an exception, use the fallback method - } catch ( e ) {} - } - - if ( elem ) { - this.empty().append( value ); - } - }, null, value, arguments.length ); - }, - - replaceWith: function() { - var ignored = []; - - // Make the changes, replacing each non-ignored context element with the new content - return domManip( this, arguments, function( elem ) { - var parent = this.parentNode; - - if ( jQuery.inArray( this, ignored ) < 0 ) { - jQuery.cleanData( getAll( this ) ); - if ( parent ) { - parent.replaceChild( elem, this ); - } - } - - // Force callback invocation - }, ignored ); - } -} ); - -jQuery.each( { - appendTo: "append", - prependTo: "prepend", - insertBefore: "before", - insertAfter: "after", - replaceAll: "replaceWith" -}, function( name, original ) { - jQuery.fn[ name ] = function( selector ) { - var elems, - ret = [], - insert = jQuery( selector ), - last = insert.length - 1, - i = 0; - - for ( ; i <= last; i++ ) { - elems = i === last ? this : this.clone( true ); - jQuery( insert[ i ] )[ original ]( elems ); - - // Support: Android <=4.0 only, PhantomJS 1 only - // .get() because push.apply(_, arraylike) throws on ancient WebKit - push.apply( ret, elems.get() ); - } - - return this.pushStack( ret ); - }; -} ); -var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" ); - -var getStyles = function( elem ) { - - // Support: IE <=11 only, Firefox <=30 (#15098, #14150) - // IE throws on elements created in popups - // FF meanwhile throws on frame elements through "defaultView.getComputedStyle" - var view = elem.ownerDocument.defaultView; - - if ( !view || !view.opener ) { - view = window; - } - - return view.getComputedStyle( elem ); - }; - -var swap = function( elem, options, callback ) { - var ret, name, - old = {}; - - // Remember the old values, and insert the new ones - for ( name in options ) { - old[ name ] = elem.style[ name ]; - elem.style[ name ] = options[ name ]; - } - - ret = callback.call( elem ); - - // Revert the old values - for ( name in options ) { - elem.style[ name ] = old[ name ]; - } - - return ret; -}; - - -var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" ); - - - -( function() { - - // Executing both pixelPosition & boxSizingReliable tests require only one layout - // so they're executed at the same time to save the second computation. - function computeStyleTests() { - - // This is a singleton, we need to execute it only once - if ( !div ) { - return; - } - - container.style.cssText = "position:absolute;left:-11111px;width:60px;" + - "margin-top:1px;padding:0;border:0"; - div.style.cssText = - "position:relative;display:block;box-sizing:border-box;overflow:scroll;" + - "margin:auto;border:1px;padding:1px;" + - "width:60%;top:1%"; - documentElement.appendChild( container ).appendChild( div ); - - var divStyle = window.getComputedStyle( div ); - pixelPositionVal = divStyle.top !== "1%"; - - // Support: Android 4.0 - 4.3 only, Firefox <=3 - 44 - reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12; - - // Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3 - // Some styles come back with percentage values, even though they shouldn't - div.style.right = "60%"; - pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36; - - // Support: IE 9 - 11 only - // Detect misreporting of content dimensions for box-sizing:border-box elements - boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36; - - // Support: IE 9 only - // Detect overflow:scroll screwiness (gh-3699) - // Support: Chrome <=64 - // Don't get tricked when zoom affects offsetWidth (gh-4029) - div.style.position = "absolute"; - scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12; - - documentElement.removeChild( container ); - - // Nullify the div so it wouldn't be stored in the memory and - // it will also be a sign that checks already performed - div = null; - } - - function roundPixelMeasures( measure ) { - return Math.round( parseFloat( measure ) ); - } - - var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal, - reliableTrDimensionsVal, reliableMarginLeftVal, - container = document.createElement( "div" ), - div = document.createElement( "div" ); - - // Finish early in limited (non-browser) environments - if ( !div.style ) { - return; - } - - // Support: IE <=9 - 11 only - // Style of cloned element affects source element cloned (#8908) - div.style.backgroundClip = "content-box"; - div.cloneNode( true ).style.backgroundClip = ""; - support.clearCloneStyle = div.style.backgroundClip === "content-box"; - - jQuery.extend( support, { - boxSizingReliable: function() { - computeStyleTests(); - return boxSizingReliableVal; - }, - pixelBoxStyles: function() { - computeStyleTests(); - return pixelBoxStylesVal; - }, - pixelPosition: function() { - computeStyleTests(); - return pixelPositionVal; - }, - reliableMarginLeft: function() { - computeStyleTests(); - return reliableMarginLeftVal; - }, - scrollboxSize: function() { - computeStyleTests(); - return scrollboxSizeVal; - }, - - // Support: IE 9 - 11+, Edge 15 - 18+ - // IE/Edge misreport `getComputedStyle` of table rows with width/height - // set in CSS while `offset*` properties report correct values. - // Behavior in IE 9 is more subtle than in newer versions & it passes - // some versions of this test; make sure not to make it pass there! - // - // Support: Firefox 70+ - // Only Firefox includes border widths - // in computed dimensions. (gh-4529) - reliableTrDimensions: function() { - var table, tr, trChild, trStyle; - if ( reliableTrDimensionsVal == null ) { - table = document.createElement( "table" ); - tr = document.createElement( "tr" ); - trChild = document.createElement( "div" ); - - table.style.cssText = "position:absolute;left:-11111px;border-collapse:separate"; - tr.style.cssText = "border:1px solid"; - - // Support: Chrome 86+ - // Height set through cssText does not get applied. - // Computed height then comes back as 0. - tr.style.height = "1px"; - trChild.style.height = "9px"; - - // Support: Android 8 Chrome 86+ - // In our bodyBackground.html iframe, - // display for all div elements is set to "inline", - // which causes a problem only in Android 8 Chrome 86. - // Ensuring the div is display: block - // gets around this issue. - trChild.style.display = "block"; - - documentElement - .appendChild( table ) - .appendChild( tr ) - .appendChild( trChild ); - - trStyle = window.getComputedStyle( tr ); - reliableTrDimensionsVal = ( parseInt( trStyle.height, 10 ) + - parseInt( trStyle.borderTopWidth, 10 ) + - parseInt( trStyle.borderBottomWidth, 10 ) ) === tr.offsetHeight; - - documentElement.removeChild( table ); - } - return reliableTrDimensionsVal; - } - } ); -} )(); - - -function curCSS( elem, name, computed ) { - var width, minWidth, maxWidth, ret, - - // Support: Firefox 51+ - // Retrieving style before computed somehow - // fixes an issue with getting wrong values - // on detached elements - style = elem.style; - - computed = computed || getStyles( elem ); - - // getPropertyValue is needed for: - // .css('filter') (IE 9 only, #12537) - // .css('--customProperty) (#3144) - if ( computed ) { - ret = computed.getPropertyValue( name ) || computed[ name ]; - - if ( ret === "" && !isAttached( elem ) ) { - ret = jQuery.style( elem, name ); - } - - // A tribute to the "awesome hack by Dean Edwards" - // Android Browser returns percentage for some values, - // but width seems to be reliably pixels. - // This is against the CSSOM draft spec: - // https://drafts.csswg.org/cssom/#resolved-values - if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) { - - // Remember the original values - width = style.width; - minWidth = style.minWidth; - maxWidth = style.maxWidth; - - // Put in the new values to get a computed value out - style.minWidth = style.maxWidth = style.width = ret; - ret = computed.width; - - // Revert the changed values - style.width = width; - style.minWidth = minWidth; - style.maxWidth = maxWidth; - } - } - - return ret !== undefined ? - - // Support: IE <=9 - 11 only - // IE returns zIndex value as an integer. - ret + "" : - ret; -} - - -function addGetHookIf( conditionFn, hookFn ) { - - // Define the hook, we'll check on the first run if it's really needed. - return { - get: function() { - if ( conditionFn() ) { - - // Hook not needed (or it's not possible to use it due - // to missing dependency), remove it. - delete this.get; - return; - } - - // Hook needed; redefine it so that the support test is not executed again. - return ( this.get = hookFn ).apply( this, arguments ); - } - }; -} - - -var cssPrefixes = [ "Webkit", "Moz", "ms" ], - emptyStyle = document.createElement( "div" ).style, - vendorProps = {}; - -// Return a vendor-prefixed property or undefined -function vendorPropName( name ) { - - // Check for vendor prefixed names - var capName = name[ 0 ].toUpperCase() + name.slice( 1 ), - i = cssPrefixes.length; - - while ( i-- ) { - name = cssPrefixes[ i ] + capName; - if ( name in emptyStyle ) { - return name; - } - } -} - -// Return a potentially-mapped jQuery.cssProps or vendor prefixed property -function finalPropName( name ) { - var final = jQuery.cssProps[ name ] || vendorProps[ name ]; - - if ( final ) { - return final; - } - if ( name in emptyStyle ) { - return name; - } - return vendorProps[ name ] = vendorPropName( name ) || name; -} - - -var - - // Swappable if display is none or starts with table - // except "table", "table-cell", or "table-caption" - // See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display - rdisplayswap = /^(none|table(?!-c[ea]).+)/, - rcustomProp = /^--/, - cssShow = { position: "absolute", visibility: "hidden", display: "block" }, - cssNormalTransform = { - letterSpacing: "0", - fontWeight: "400" - }; - -function setPositiveNumber( _elem, value, subtract ) { - - // Any relative (+/-) values have already been - // normalized at this point - var matches = rcssNum.exec( value ); - return matches ? - - // Guard against undefined "subtract", e.g., when used as in cssHooks - Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) : - value; -} - -function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) { - var i = dimension === "width" ? 1 : 0, - extra = 0, - delta = 0; - - // Adjustment may not be necessary - if ( box === ( isBorderBox ? "border" : "content" ) ) { - return 0; - } - - for ( ; i < 4; i += 2 ) { - - // Both box models exclude margin - if ( box === "margin" ) { - delta += jQuery.css( elem, box + cssExpand[ i ], true, styles ); - } - - // If we get here with a content-box, we're seeking "padding" or "border" or "margin" - if ( !isBorderBox ) { - - // Add padding - delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); - - // For "border" or "margin", add border - if ( box !== "padding" ) { - delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); - - // But still keep track of it otherwise - } else { - extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); - } - - // If we get here with a border-box (content + padding + border), we're seeking "content" or - // "padding" or "margin" - } else { - - // For "content", subtract padding - if ( box === "content" ) { - delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); - } - - // For "content" or "padding", subtract border - if ( box !== "margin" ) { - delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); - } - } - } - - // Account for positive content-box scroll gutter when requested by providing computedVal - if ( !isBorderBox && computedVal >= 0 ) { - - // offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border - // Assuming integer scroll gutter, subtract the rest and round down - delta += Math.max( 0, Math.ceil( - elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - - computedVal - - delta - - extra - - 0.5 - - // If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter - // Use an explicit zero to avoid NaN (gh-3964) - ) ) || 0; - } - - return delta; -} - -function getWidthOrHeight( elem, dimension, extra ) { - - // Start with computed style - var styles = getStyles( elem ), - - // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322). - // Fake content-box until we know it's needed to know the true value. - boxSizingNeeded = !support.boxSizingReliable() || extra, - isBorderBox = boxSizingNeeded && - jQuery.css( elem, "boxSizing", false, styles ) === "border-box", - valueIsBorderBox = isBorderBox, - - val = curCSS( elem, dimension, styles ), - offsetProp = "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ); - - // Support: Firefox <=54 - // Return a confounding non-pixel value or feign ignorance, as appropriate. - if ( rnumnonpx.test( val ) ) { - if ( !extra ) { - return val; - } - val = "auto"; - } - - - // Support: IE 9 - 11 only - // Use offsetWidth/offsetHeight for when box sizing is unreliable. - // In those cases, the computed value can be trusted to be border-box. - if ( ( !support.boxSizingReliable() && isBorderBox || - - // Support: IE 10 - 11+, Edge 15 - 18+ - // IE/Edge misreport `getComputedStyle` of table rows with width/height - // set in CSS while `offset*` properties report correct values. - // Interestingly, in some cases IE 9 doesn't suffer from this issue. - !support.reliableTrDimensions() && nodeName( elem, "tr" ) || - - // Fall back to offsetWidth/offsetHeight when value is "auto" - // This happens for inline elements with no explicit setting (gh-3571) - val === "auto" || - - // Support: Android <=4.1 - 4.3 only - // Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602) - !parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) && - - // Make sure the element is visible & connected - elem.getClientRects().length ) { - - isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; - - // Where available, offsetWidth/offsetHeight approximate border box dimensions. - // Where not available (e.g., SVG), assume unreliable box-sizing and interpret the - // retrieved value as a content box dimension. - valueIsBorderBox = offsetProp in elem; - if ( valueIsBorderBox ) { - val = elem[ offsetProp ]; - } - } - - // Normalize "" and auto - val = parseFloat( val ) || 0; - - // Adjust for the element's box model - return ( val + - boxModelAdjustment( - elem, - dimension, - extra || ( isBorderBox ? "border" : "content" ), - valueIsBorderBox, - styles, - - // Provide the current computed size to request scroll gutter calculation (gh-3589) - val - ) - ) + "px"; -} - -jQuery.extend( { - - // Add in style property hooks for overriding the default - // behavior of getting and setting a style property - cssHooks: { - opacity: { - get: function( elem, computed ) { - if ( computed ) { - - // We should always get a number back from opacity - var ret = curCSS( elem, "opacity" ); - return ret === "" ? "1" : ret; - } - } - } - }, - - // Don't automatically add "px" to these possibly-unitless properties - cssNumber: { - "animationIterationCount": true, - "columnCount": true, - "fillOpacity": true, - "flexGrow": true, - "flexShrink": true, - "fontWeight": true, - "gridArea": true, - "gridColumn": true, - "gridColumnEnd": true, - "gridColumnStart": true, - "gridRow": true, - "gridRowEnd": true, - "gridRowStart": true, - "lineHeight": true, - "opacity": true, - "order": true, - "orphans": true, - "widows": true, - "zIndex": true, - "zoom": true - }, - - // Add in properties whose names you wish to fix before - // setting or getting the value - cssProps: {}, - - // Get and set the style property on a DOM Node - style: function( elem, name, value, extra ) { - - // Don't set styles on text and comment nodes - if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { - return; - } - - // Make sure that we're working with the right name - var ret, type, hooks, - origName = camelCase( name ), - isCustomProp = rcustomProp.test( name ), - style = elem.style; - - // Make sure that we're working with the right name. We don't - // want to query the value if it is a CSS custom property - // since they are user-defined. - if ( !isCustomProp ) { - name = finalPropName( origName ); - } - - // Gets hook for the prefixed version, then unprefixed version - hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; - - // Check if we're setting a value - if ( value !== undefined ) { - type = typeof value; - - // Convert "+=" or "-=" to relative numbers (#7345) - if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) { - value = adjustCSS( elem, name, ret ); - - // Fixes bug #9237 - type = "number"; - } - - // Make sure that null and NaN values aren't set (#7116) - if ( value == null || value !== value ) { - return; - } - - // If a number was passed in, add the unit (except for certain CSS properties) - // The isCustomProp check can be removed in jQuery 4.0 when we only auto-append - // "px" to a few hardcoded values. - if ( type === "number" && !isCustomProp ) { - value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" ); - } - - // background-* props affect original clone's values - if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) { - style[ name ] = "inherit"; - } - - // If a hook was provided, use that value, otherwise just set the specified value - if ( !hooks || !( "set" in hooks ) || - ( value = hooks.set( elem, value, extra ) ) !== undefined ) { - - if ( isCustomProp ) { - style.setProperty( name, value ); - } else { - style[ name ] = value; - } - } - - } else { - - // If a hook was provided get the non-computed value from there - if ( hooks && "get" in hooks && - ( ret = hooks.get( elem, false, extra ) ) !== undefined ) { - - return ret; - } - - // Otherwise just get the value from the style object - return style[ name ]; - } - }, - - css: function( elem, name, extra, styles ) { - var val, num, hooks, - origName = camelCase( name ), - isCustomProp = rcustomProp.test( name ); - - // Make sure that we're working with the right name. We don't - // want to modify the value if it is a CSS custom property - // since they are user-defined. - if ( !isCustomProp ) { - name = finalPropName( origName ); - } - - // Try prefixed name followed by the unprefixed name - hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; - - // If a hook was provided get the computed value from there - if ( hooks && "get" in hooks ) { - val = hooks.get( elem, true, extra ); - } - - // Otherwise, if a way to get the computed value exists, use that - if ( val === undefined ) { - val = curCSS( elem, name, styles ); - } - - // Convert "normal" to computed value - if ( val === "normal" && name in cssNormalTransform ) { - val = cssNormalTransform[ name ]; - } - - // Make numeric if forced or a qualifier was provided and val looks numeric - if ( extra === "" || extra ) { - num = parseFloat( val ); - return extra === true || isFinite( num ) ? num || 0 : val; - } - - return val; - } -} ); - -jQuery.each( [ "height", "width" ], function( _i, dimension ) { - jQuery.cssHooks[ dimension ] = { - get: function( elem, computed, extra ) { - if ( computed ) { - - // Certain elements can have dimension info if we invisibly show them - // but it must have a current display style that would benefit - return rdisplayswap.test( jQuery.css( elem, "display" ) ) && - - // Support: Safari 8+ - // Table columns in Safari have non-zero offsetWidth & zero - // getBoundingClientRect().width unless display is changed. - // Support: IE <=11 only - // Running getBoundingClientRect on a disconnected node - // in IE throws an error. - ( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ? - swap( elem, cssShow, function() { - return getWidthOrHeight( elem, dimension, extra ); - } ) : - getWidthOrHeight( elem, dimension, extra ); - } - }, - - set: function( elem, value, extra ) { - var matches, - styles = getStyles( elem ), - - // Only read styles.position if the test has a chance to fail - // to avoid forcing a reflow. - scrollboxSizeBuggy = !support.scrollboxSize() && - styles.position === "absolute", - - // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991) - boxSizingNeeded = scrollboxSizeBuggy || extra, - isBorderBox = boxSizingNeeded && - jQuery.css( elem, "boxSizing", false, styles ) === "border-box", - subtract = extra ? - boxModelAdjustment( - elem, - dimension, - extra, - isBorderBox, - styles - ) : - 0; - - // Account for unreliable border-box dimensions by comparing offset* to computed and - // faking a content-box to get border and padding (gh-3699) - if ( isBorderBox && scrollboxSizeBuggy ) { - subtract -= Math.ceil( - elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - - parseFloat( styles[ dimension ] ) - - boxModelAdjustment( elem, dimension, "border", false, styles ) - - 0.5 - ); - } - - // Convert to pixels if value adjustment is needed - if ( subtract && ( matches = rcssNum.exec( value ) ) && - ( matches[ 3 ] || "px" ) !== "px" ) { - - elem.style[ dimension ] = value; - value = jQuery.css( elem, dimension ); - } - - return setPositiveNumber( elem, value, subtract ); - } - }; -} ); - -jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft, - function( elem, computed ) { - if ( computed ) { - return ( parseFloat( curCSS( elem, "marginLeft" ) ) || - elem.getBoundingClientRect().left - - swap( elem, { marginLeft: 0 }, function() { - return elem.getBoundingClientRect().left; - } ) - ) + "px"; - } - } -); - -// These hooks are used by animate to expand properties -jQuery.each( { - margin: "", - padding: "", - border: "Width" -}, function( prefix, suffix ) { - jQuery.cssHooks[ prefix + suffix ] = { - expand: function( value ) { - var i = 0, - expanded = {}, - - // Assumes a single number if not a string - parts = typeof value === "string" ? value.split( " " ) : [ value ]; - - for ( ; i < 4; i++ ) { - expanded[ prefix + cssExpand[ i ] + suffix ] = - parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; - } - - return expanded; - } - }; - - if ( prefix !== "margin" ) { - jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; - } -} ); - -jQuery.fn.extend( { - css: function( name, value ) { - return access( this, function( elem, name, value ) { - var styles, len, - map = {}, - i = 0; - - if ( Array.isArray( name ) ) { - styles = getStyles( elem ); - len = name.length; - - for ( ; i < len; i++ ) { - map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); - } - - return map; - } - - return value !== undefined ? - jQuery.style( elem, name, value ) : - jQuery.css( elem, name ); - }, name, value, arguments.length > 1 ); - } -} ); - - -function Tween( elem, options, prop, end, easing ) { - return new Tween.prototype.init( elem, options, prop, end, easing ); -} -jQuery.Tween = Tween; - -Tween.prototype = { - constructor: Tween, - init: function( elem, options, prop, end, easing, unit ) { - this.elem = elem; - this.prop = prop; - this.easing = easing || jQuery.easing._default; - this.options = options; - this.start = this.now = this.cur(); - this.end = end; - this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); - }, - cur: function() { - var hooks = Tween.propHooks[ this.prop ]; - - return hooks && hooks.get ? - hooks.get( this ) : - Tween.propHooks._default.get( this ); - }, - run: function( percent ) { - var eased, - hooks = Tween.propHooks[ this.prop ]; - - if ( this.options.duration ) { - this.pos = eased = jQuery.easing[ this.easing ]( - percent, this.options.duration * percent, 0, 1, this.options.duration - ); - } else { - this.pos = eased = percent; - } - this.now = ( this.end - this.start ) * eased + this.start; - - if ( this.options.step ) { - this.options.step.call( this.elem, this.now, this ); - } - - if ( hooks && hooks.set ) { - hooks.set( this ); - } else { - Tween.propHooks._default.set( this ); - } - return this; - } -}; - -Tween.prototype.init.prototype = Tween.prototype; - -Tween.propHooks = { - _default: { - get: function( tween ) { - var result; - - // Use a property on the element directly when it is not a DOM element, - // or when there is no matching style property that exists. - if ( tween.elem.nodeType !== 1 || - tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) { - return tween.elem[ tween.prop ]; - } - - // Passing an empty string as a 3rd parameter to .css will automatically - // attempt a parseFloat and fallback to a string if the parse fails. - // Simple values such as "10px" are parsed to Float; - // complex values such as "rotate(1rad)" are returned as-is. - result = jQuery.css( tween.elem, tween.prop, "" ); - - // Empty strings, null, undefined and "auto" are converted to 0. - return !result || result === "auto" ? 0 : result; - }, - set: function( tween ) { - - // Use step hook for back compat. - // Use cssHook if its there. - // Use .style if available and use plain properties where available. - if ( jQuery.fx.step[ tween.prop ] ) { - jQuery.fx.step[ tween.prop ]( tween ); - } else if ( tween.elem.nodeType === 1 && ( - jQuery.cssHooks[ tween.prop ] || - tween.elem.style[ finalPropName( tween.prop ) ] != null ) ) { - jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); - } else { - tween.elem[ tween.prop ] = tween.now; - } - } - } -}; - -// Support: IE <=9 only -// Panic based approach to setting things on disconnected nodes -Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { - set: function( tween ) { - if ( tween.elem.nodeType && tween.elem.parentNode ) { - tween.elem[ tween.prop ] = tween.now; - } - } -}; - -jQuery.easing = { - linear: function( p ) { - return p; - }, - swing: function( p ) { - return 0.5 - Math.cos( p * Math.PI ) / 2; - }, - _default: "swing" -}; - -jQuery.fx = Tween.prototype.init; - -// Back compat <1.8 extension point -jQuery.fx.step = {}; - - - - -var - fxNow, inProgress, - rfxtypes = /^(?:toggle|show|hide)$/, - rrun = /queueHooks$/; - -function schedule() { - if ( inProgress ) { - if ( document.hidden === false && window.requestAnimationFrame ) { - window.requestAnimationFrame( schedule ); - } else { - window.setTimeout( schedule, jQuery.fx.interval ); - } - - jQuery.fx.tick(); - } -} - -// Animations created synchronously will run synchronously -function createFxNow() { - window.setTimeout( function() { - fxNow = undefined; - } ); - return ( fxNow = Date.now() ); -} - -// Generate parameters to create a standard animation -function genFx( type, includeWidth ) { - var which, - i = 0, - attrs = { height: type }; - - // If we include width, step value is 1 to do all cssExpand values, - // otherwise step value is 2 to skip over Left and Right - includeWidth = includeWidth ? 1 : 0; - for ( ; i < 4; i += 2 - includeWidth ) { - which = cssExpand[ i ]; - attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; - } - - if ( includeWidth ) { - attrs.opacity = attrs.width = type; - } - - return attrs; -} - -function createTween( value, prop, animation ) { - var tween, - collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ), - index = 0, - length = collection.length; - for ( ; index < length; index++ ) { - if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) { - - // We're done with this property - return tween; - } - } -} - -function defaultPrefilter( elem, props, opts ) { - var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display, - isBox = "width" in props || "height" in props, - anim = this, - orig = {}, - style = elem.style, - hidden = elem.nodeType && isHiddenWithinTree( elem ), - dataShow = dataPriv.get( elem, "fxshow" ); - - // Queue-skipping animations hijack the fx hooks - if ( !opts.queue ) { - hooks = jQuery._queueHooks( elem, "fx" ); - if ( hooks.unqueued == null ) { - hooks.unqueued = 0; - oldfire = hooks.empty.fire; - hooks.empty.fire = function() { - if ( !hooks.unqueued ) { - oldfire(); - } - }; - } - hooks.unqueued++; - - anim.always( function() { - - // Ensure the complete handler is called before this completes - anim.always( function() { - hooks.unqueued--; - if ( !jQuery.queue( elem, "fx" ).length ) { - hooks.empty.fire(); - } - } ); - } ); - } - - // Detect show/hide animations - for ( prop in props ) { - value = props[ prop ]; - if ( rfxtypes.test( value ) ) { - delete props[ prop ]; - toggle = toggle || value === "toggle"; - if ( value === ( hidden ? "hide" : "show" ) ) { - - // Pretend to be hidden if this is a "show" and - // there is still data from a stopped show/hide - if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { - hidden = true; - - // Ignore all other no-op show/hide data - } else { - continue; - } - } - orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); - } - } - - // Bail out if this is a no-op like .hide().hide() - propTween = !jQuery.isEmptyObject( props ); - if ( !propTween && jQuery.isEmptyObject( orig ) ) { - return; - } - - // Restrict "overflow" and "display" styles during box animations - if ( isBox && elem.nodeType === 1 ) { - - // Support: IE <=9 - 11, Edge 12 - 15 - // Record all 3 overflow attributes because IE does not infer the shorthand - // from identically-valued overflowX and overflowY and Edge just mirrors - // the overflowX value there. - opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; - - // Identify a display type, preferring old show/hide data over the CSS cascade - restoreDisplay = dataShow && dataShow.display; - if ( restoreDisplay == null ) { - restoreDisplay = dataPriv.get( elem, "display" ); - } - display = jQuery.css( elem, "display" ); - if ( display === "none" ) { - if ( restoreDisplay ) { - display = restoreDisplay; - } else { - - // Get nonempty value(s) by temporarily forcing visibility - showHide( [ elem ], true ); - restoreDisplay = elem.style.display || restoreDisplay; - display = jQuery.css( elem, "display" ); - showHide( [ elem ] ); - } - } - - // Animate inline elements as inline-block - if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) { - if ( jQuery.css( elem, "float" ) === "none" ) { - - // Restore the original display value at the end of pure show/hide animations - if ( !propTween ) { - anim.done( function() { - style.display = restoreDisplay; - } ); - if ( restoreDisplay == null ) { - display = style.display; - restoreDisplay = display === "none" ? "" : display; - } - } - style.display = "inline-block"; - } - } - } - - if ( opts.overflow ) { - style.overflow = "hidden"; - anim.always( function() { - style.overflow = opts.overflow[ 0 ]; - style.overflowX = opts.overflow[ 1 ]; - style.overflowY = opts.overflow[ 2 ]; - } ); - } - - // Implement show/hide animations - propTween = false; - for ( prop in orig ) { - - // General show/hide setup for this element animation - if ( !propTween ) { - if ( dataShow ) { - if ( "hidden" in dataShow ) { - hidden = dataShow.hidden; - } - } else { - dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } ); - } - - // Store hidden/visible for toggle so `.stop().toggle()` "reverses" - if ( toggle ) { - dataShow.hidden = !hidden; - } - - // Show elements before animating them - if ( hidden ) { - showHide( [ elem ], true ); - } - - /* eslint-disable no-loop-func */ - - anim.done( function() { - - /* eslint-enable no-loop-func */ - - // The final step of a "hide" animation is actually hiding the element - if ( !hidden ) { - showHide( [ elem ] ); - } - dataPriv.remove( elem, "fxshow" ); - for ( prop in orig ) { - jQuery.style( elem, prop, orig[ prop ] ); - } - } ); - } - - // Per-property setup - propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); - if ( !( prop in dataShow ) ) { - dataShow[ prop ] = propTween.start; - if ( hidden ) { - propTween.end = propTween.start; - propTween.start = 0; - } - } - } -} - -function propFilter( props, specialEasing ) { - var index, name, easing, value, hooks; - - // camelCase, specialEasing and expand cssHook pass - for ( index in props ) { - name = camelCase( index ); - easing = specialEasing[ name ]; - value = props[ index ]; - if ( Array.isArray( value ) ) { - easing = value[ 1 ]; - value = props[ index ] = value[ 0 ]; - } - - if ( index !== name ) { - props[ name ] = value; - delete props[ index ]; - } - - hooks = jQuery.cssHooks[ name ]; - if ( hooks && "expand" in hooks ) { - value = hooks.expand( value ); - delete props[ name ]; - - // Not quite $.extend, this won't overwrite existing keys. - // Reusing 'index' because we have the correct "name" - for ( index in value ) { - if ( !( index in props ) ) { - props[ index ] = value[ index ]; - specialEasing[ index ] = easing; - } - } - } else { - specialEasing[ name ] = easing; - } - } -} - -function Animation( elem, properties, options ) { - var result, - stopped, - index = 0, - length = Animation.prefilters.length, - deferred = jQuery.Deferred().always( function() { - - // Don't match elem in the :animated selector - delete tick.elem; - } ), - tick = function() { - if ( stopped ) { - return false; - } - var currentTime = fxNow || createFxNow(), - remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), - - // Support: Android 2.3 only - // Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497) - temp = remaining / animation.duration || 0, - percent = 1 - temp, - index = 0, - length = animation.tweens.length; - - for ( ; index < length; index++ ) { - animation.tweens[ index ].run( percent ); - } - - deferred.notifyWith( elem, [ animation, percent, remaining ] ); - - // If there's more to do, yield - if ( percent < 1 && length ) { - return remaining; - } - - // If this was an empty animation, synthesize a final progress notification - if ( !length ) { - deferred.notifyWith( elem, [ animation, 1, 0 ] ); - } - - // Resolve the animation and report its conclusion - deferred.resolveWith( elem, [ animation ] ); - return false; - }, - animation = deferred.promise( { - elem: elem, - props: jQuery.extend( {}, properties ), - opts: jQuery.extend( true, { - specialEasing: {}, - easing: jQuery.easing._default - }, options ), - originalProperties: properties, - originalOptions: options, - startTime: fxNow || createFxNow(), - duration: options.duration, - tweens: [], - createTween: function( prop, end ) { - var tween = jQuery.Tween( elem, animation.opts, prop, end, - animation.opts.specialEasing[ prop ] || animation.opts.easing ); - animation.tweens.push( tween ); - return tween; - }, - stop: function( gotoEnd ) { - var index = 0, - - // If we are going to the end, we want to run all the tweens - // otherwise we skip this part - length = gotoEnd ? animation.tweens.length : 0; - if ( stopped ) { - return this; - } - stopped = true; - for ( ; index < length; index++ ) { - animation.tweens[ index ].run( 1 ); - } - - // Resolve when we played the last frame; otherwise, reject - if ( gotoEnd ) { - deferred.notifyWith( elem, [ animation, 1, 0 ] ); - deferred.resolveWith( elem, [ animation, gotoEnd ] ); - } else { - deferred.rejectWith( elem, [ animation, gotoEnd ] ); - } - return this; - } - } ), - props = animation.props; - - propFilter( props, animation.opts.specialEasing ); - - for ( ; index < length; index++ ) { - result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts ); - if ( result ) { - if ( isFunction( result.stop ) ) { - jQuery._queueHooks( animation.elem, animation.opts.queue ).stop = - result.stop.bind( result ); - } - return result; - } - } - - jQuery.map( props, createTween, animation ); - - if ( isFunction( animation.opts.start ) ) { - animation.opts.start.call( elem, animation ); - } - - // Attach callbacks from options - animation - .progress( animation.opts.progress ) - .done( animation.opts.done, animation.opts.complete ) - .fail( animation.opts.fail ) - .always( animation.opts.always ); - - jQuery.fx.timer( - jQuery.extend( tick, { - elem: elem, - anim: animation, - queue: animation.opts.queue - } ) - ); - - return animation; -} - -jQuery.Animation = jQuery.extend( Animation, { - - tweeners: { - "*": [ function( prop, value ) { - var tween = this.createTween( prop, value ); - adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween ); - return tween; - } ] - }, - - tweener: function( props, callback ) { - if ( isFunction( props ) ) { - callback = props; - props = [ "*" ]; - } else { - props = props.match( rnothtmlwhite ); - } - - var prop, - index = 0, - length = props.length; - - for ( ; index < length; index++ ) { - prop = props[ index ]; - Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || []; - Animation.tweeners[ prop ].unshift( callback ); - } - }, - - prefilters: [ defaultPrefilter ], - - prefilter: function( callback, prepend ) { - if ( prepend ) { - Animation.prefilters.unshift( callback ); - } else { - Animation.prefilters.push( callback ); - } - } -} ); - -jQuery.speed = function( speed, easing, fn ) { - var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { - complete: fn || !fn && easing || - isFunction( speed ) && speed, - duration: speed, - easing: fn && easing || easing && !isFunction( easing ) && easing - }; - - // Go to the end state if fx are off - if ( jQuery.fx.off ) { - opt.duration = 0; - - } else { - if ( typeof opt.duration !== "number" ) { - if ( opt.duration in jQuery.fx.speeds ) { - opt.duration = jQuery.fx.speeds[ opt.duration ]; - - } else { - opt.duration = jQuery.fx.speeds._default; - } - } - } - - // Normalize opt.queue - true/undefined/null -> "fx" - if ( opt.queue == null || opt.queue === true ) { - opt.queue = "fx"; - } - - // Queueing - opt.old = opt.complete; - - opt.complete = function() { - if ( isFunction( opt.old ) ) { - opt.old.call( this ); - } - - if ( opt.queue ) { - jQuery.dequeue( this, opt.queue ); - } - }; - - return opt; -}; - -jQuery.fn.extend( { - fadeTo: function( speed, to, easing, callback ) { - - // Show any hidden elements after setting opacity to 0 - return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show() - - // Animate to the value specified - .end().animate( { opacity: to }, speed, easing, callback ); - }, - animate: function( prop, speed, easing, callback ) { - var empty = jQuery.isEmptyObject( prop ), - optall = jQuery.speed( speed, easing, callback ), - doAnimation = function() { - - // Operate on a copy of prop so per-property easing won't be lost - var anim = Animation( this, jQuery.extend( {}, prop ), optall ); - - // Empty animations, or finishing resolves immediately - if ( empty || dataPriv.get( this, "finish" ) ) { - anim.stop( true ); - } - }; - - doAnimation.finish = doAnimation; - - return empty || optall.queue === false ? - this.each( doAnimation ) : - this.queue( optall.queue, doAnimation ); - }, - stop: function( type, clearQueue, gotoEnd ) { - var stopQueue = function( hooks ) { - var stop = hooks.stop; - delete hooks.stop; - stop( gotoEnd ); - }; - - if ( typeof type !== "string" ) { - gotoEnd = clearQueue; - clearQueue = type; - type = undefined; - } - if ( clearQueue ) { - this.queue( type || "fx", [] ); - } - - return this.each( function() { - var dequeue = true, - index = type != null && type + "queueHooks", - timers = jQuery.timers, - data = dataPriv.get( this ); - - if ( index ) { - if ( data[ index ] && data[ index ].stop ) { - stopQueue( data[ index ] ); - } - } else { - for ( index in data ) { - if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { - stopQueue( data[ index ] ); - } - } - } - - for ( index = timers.length; index--; ) { - if ( timers[ index ].elem === this && - ( type == null || timers[ index ].queue === type ) ) { - - timers[ index ].anim.stop( gotoEnd ); - dequeue = false; - timers.splice( index, 1 ); - } - } - - // Start the next in the queue if the last step wasn't forced. - // Timers currently will call their complete callbacks, which - // will dequeue but only if they were gotoEnd. - if ( dequeue || !gotoEnd ) { - jQuery.dequeue( this, type ); - } - } ); - }, - finish: function( type ) { - if ( type !== false ) { - type = type || "fx"; - } - return this.each( function() { - var index, - data = dataPriv.get( this ), - queue = data[ type + "queue" ], - hooks = data[ type + "queueHooks" ], - timers = jQuery.timers, - length = queue ? queue.length : 0; - - // Enable finishing flag on private data - data.finish = true; - - // Empty the queue first - jQuery.queue( this, type, [] ); - - if ( hooks && hooks.stop ) { - hooks.stop.call( this, true ); - } - - // Look for any active animations, and finish them - for ( index = timers.length; index--; ) { - if ( timers[ index ].elem === this && timers[ index ].queue === type ) { - timers[ index ].anim.stop( true ); - timers.splice( index, 1 ); - } - } - - // Look for any animations in the old queue and finish them - for ( index = 0; index < length; index++ ) { - if ( queue[ index ] && queue[ index ].finish ) { - queue[ index ].finish.call( this ); - } - } - - // Turn off finishing flag - delete data.finish; - } ); - } -} ); - -jQuery.each( [ "toggle", "show", "hide" ], function( _i, name ) { - var cssFn = jQuery.fn[ name ]; - jQuery.fn[ name ] = function( speed, easing, callback ) { - return speed == null || typeof speed === "boolean" ? - cssFn.apply( this, arguments ) : - this.animate( genFx( name, true ), speed, easing, callback ); - }; -} ); - -// Generate shortcuts for custom animations -jQuery.each( { - slideDown: genFx( "show" ), - slideUp: genFx( "hide" ), - slideToggle: genFx( "toggle" ), - fadeIn: { opacity: "show" }, - fadeOut: { opacity: "hide" }, - fadeToggle: { opacity: "toggle" } -}, function( name, props ) { - jQuery.fn[ name ] = function( speed, easing, callback ) { - return this.animate( props, speed, easing, callback ); - }; -} ); - -jQuery.timers = []; -jQuery.fx.tick = function() { - var timer, - i = 0, - timers = jQuery.timers; - - fxNow = Date.now(); - - for ( ; i < timers.length; i++ ) { - timer = timers[ i ]; - - // Run the timer and safely remove it when done (allowing for external removal) - if ( !timer() && timers[ i ] === timer ) { - timers.splice( i--, 1 ); - } - } - - if ( !timers.length ) { - jQuery.fx.stop(); - } - fxNow = undefined; -}; - -jQuery.fx.timer = function( timer ) { - jQuery.timers.push( timer ); - jQuery.fx.start(); -}; - -jQuery.fx.interval = 13; -jQuery.fx.start = function() { - if ( inProgress ) { - return; - } - - inProgress = true; - schedule(); -}; - -jQuery.fx.stop = function() { - inProgress = null; -}; - -jQuery.fx.speeds = { - slow: 600, - fast: 200, - - // Default speed - _default: 400 -}; - - -// Based off of the plugin by Clint Helfers, with permission. -// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/ -jQuery.fn.delay = function( time, type ) { - time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; - type = type || "fx"; - - return this.queue( type, function( next, hooks ) { - var timeout = window.setTimeout( next, time ); - hooks.stop = function() { - window.clearTimeout( timeout ); - }; - } ); -}; - - -( function() { - var input = document.createElement( "input" ), - select = document.createElement( "select" ), - opt = select.appendChild( document.createElement( "option" ) ); - - input.type = "checkbox"; - - // Support: Android <=4.3 only - // Default value for a checkbox should be "on" - support.checkOn = input.value !== ""; - - // Support: IE <=11 only - // Must access selectedIndex to make default options select - support.optSelected = opt.selected; - - // Support: IE <=11 only - // An input loses its value after becoming a radio - input = document.createElement( "input" ); - input.value = "t"; - input.type = "radio"; - support.radioValue = input.value === "t"; -} )(); - - -var boolHook, - attrHandle = jQuery.expr.attrHandle; - -jQuery.fn.extend( { - attr: function( name, value ) { - return access( this, jQuery.attr, name, value, arguments.length > 1 ); - }, - - removeAttr: function( name ) { - return this.each( function() { - jQuery.removeAttr( this, name ); - } ); - } -} ); - -jQuery.extend( { - attr: function( elem, name, value ) { - var ret, hooks, - nType = elem.nodeType; - - // Don't get/set attributes on text, comment and attribute nodes - if ( nType === 3 || nType === 8 || nType === 2 ) { - return; - } - - // Fallback to prop when attributes are not supported - if ( typeof elem.getAttribute === "undefined" ) { - return jQuery.prop( elem, name, value ); - } - - // Attribute hooks are determined by the lowercase version - // Grab necessary hook if one is defined - if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { - hooks = jQuery.attrHooks[ name.toLowerCase() ] || - ( jQuery.expr.match.bool.test( name ) ? boolHook : undefined ); - } - - if ( value !== undefined ) { - if ( value === null ) { - jQuery.removeAttr( elem, name ); - return; - } - - if ( hooks && "set" in hooks && - ( ret = hooks.set( elem, value, name ) ) !== undefined ) { - return ret; - } - - elem.setAttribute( name, value + "" ); - return value; - } - - if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { - return ret; - } - - ret = jQuery.find.attr( elem, name ); - - // Non-existent attributes return null, we normalize to undefined - return ret == null ? undefined : ret; - }, - - attrHooks: { - type: { - set: function( elem, value ) { - if ( !support.radioValue && value === "radio" && - nodeName( elem, "input" ) ) { - var val = elem.value; - elem.setAttribute( "type", value ); - if ( val ) { - elem.value = val; - } - return value; - } - } - } - }, - - removeAttr: function( elem, value ) { - var name, - i = 0, - - // Attribute names can contain non-HTML whitespace characters - // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2 - attrNames = value && value.match( rnothtmlwhite ); - - if ( attrNames && elem.nodeType === 1 ) { - while ( ( name = attrNames[ i++ ] ) ) { - elem.removeAttribute( name ); - } - } - } -} ); - -// Hooks for boolean attributes -boolHook = { - set: function( elem, value, name ) { - if ( value === false ) { - - // Remove boolean attributes when set to false - jQuery.removeAttr( elem, name ); - } else { - elem.setAttribute( name, name ); - } - return name; - } -}; - -jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) { - var getter = attrHandle[ name ] || jQuery.find.attr; - - attrHandle[ name ] = function( elem, name, isXML ) { - var ret, handle, - lowercaseName = name.toLowerCase(); - - if ( !isXML ) { - - // Avoid an infinite loop by temporarily removing this function from the getter - handle = attrHandle[ lowercaseName ]; - attrHandle[ lowercaseName ] = ret; - ret = getter( elem, name, isXML ) != null ? - lowercaseName : - null; - attrHandle[ lowercaseName ] = handle; - } - return ret; - }; -} ); - - - - -var rfocusable = /^(?:input|select|textarea|button)$/i, - rclickable = /^(?:a|area)$/i; - -jQuery.fn.extend( { - prop: function( name, value ) { - return access( this, jQuery.prop, name, value, arguments.length > 1 ); - }, - - removeProp: function( name ) { - return this.each( function() { - delete this[ jQuery.propFix[ name ] || name ]; - } ); - } -} ); - -jQuery.extend( { - prop: function( elem, name, value ) { - var ret, hooks, - nType = elem.nodeType; - - // Don't get/set properties on text, comment and attribute nodes - if ( nType === 3 || nType === 8 || nType === 2 ) { - return; - } - - if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { - - // Fix name and attach hooks - name = jQuery.propFix[ name ] || name; - hooks = jQuery.propHooks[ name ]; - } - - if ( value !== undefined ) { - if ( hooks && "set" in hooks && - ( ret = hooks.set( elem, value, name ) ) !== undefined ) { - return ret; - } - - return ( elem[ name ] = value ); - } - - if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { - return ret; - } - - return elem[ name ]; - }, - - propHooks: { - tabIndex: { - get: function( elem ) { - - // Support: IE <=9 - 11 only - // elem.tabIndex doesn't always return the - // correct value when it hasn't been explicitly set - // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ - // Use proper attribute retrieval(#12072) - var tabindex = jQuery.find.attr( elem, "tabindex" ); - - if ( tabindex ) { - return parseInt( tabindex, 10 ); - } - - if ( - rfocusable.test( elem.nodeName ) || - rclickable.test( elem.nodeName ) && - elem.href - ) { - return 0; - } - - return -1; - } - } - }, - - propFix: { - "for": "htmlFor", - "class": "className" - } -} ); - -// Support: IE <=11 only -// Accessing the selectedIndex property -// forces the browser to respect setting selected -// on the option -// The getter ensures a default option is selected -// when in an optgroup -// eslint rule "no-unused-expressions" is disabled for this code -// since it considers such accessions noop -if ( !support.optSelected ) { - jQuery.propHooks.selected = { - get: function( elem ) { - - /* eslint no-unused-expressions: "off" */ - - var parent = elem.parentNode; - if ( parent && parent.parentNode ) { - parent.parentNode.selectedIndex; - } - return null; - }, - set: function( elem ) { - - /* eslint no-unused-expressions: "off" */ - - var parent = elem.parentNode; - if ( parent ) { - parent.selectedIndex; - - if ( parent.parentNode ) { - parent.parentNode.selectedIndex; - } - } - } - }; -} - -jQuery.each( [ - "tabIndex", - "readOnly", - "maxLength", - "cellSpacing", - "cellPadding", - "rowSpan", - "colSpan", - "useMap", - "frameBorder", - "contentEditable" -], function() { - jQuery.propFix[ this.toLowerCase() ] = this; -} ); - - - - - // Strip and collapse whitespace according to HTML spec - // https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace - function stripAndCollapse( value ) { - var tokens = value.match( rnothtmlwhite ) || []; - return tokens.join( " " ); - } - - -function getClass( elem ) { - return elem.getAttribute && elem.getAttribute( "class" ) || ""; -} - -function classesToArray( value ) { - if ( Array.isArray( value ) ) { - return value; - } - if ( typeof value === "string" ) { - return value.match( rnothtmlwhite ) || []; - } - return []; -} - -jQuery.fn.extend( { - addClass: function( value ) { - var classes, elem, cur, curValue, clazz, j, finalValue, - i = 0; - - if ( isFunction( value ) ) { - return this.each( function( j ) { - jQuery( this ).addClass( value.call( this, j, getClass( this ) ) ); - } ); - } - - classes = classesToArray( value ); - - if ( classes.length ) { - while ( ( elem = this[ i++ ] ) ) { - curValue = getClass( elem ); - cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); - - if ( cur ) { - j = 0; - while ( ( clazz = classes[ j++ ] ) ) { - if ( cur.indexOf( " " + clazz + " " ) < 0 ) { - cur += clazz + " "; - } - } - - // Only assign if different to avoid unneeded rendering. - finalValue = stripAndCollapse( cur ); - if ( curValue !== finalValue ) { - elem.setAttribute( "class", finalValue ); - } - } - } - } - - return this; - }, - - removeClass: function( value ) { - var classes, elem, cur, curValue, clazz, j, finalValue, - i = 0; - - if ( isFunction( value ) ) { - return this.each( function( j ) { - jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) ); - } ); - } - - if ( !arguments.length ) { - return this.attr( "class", "" ); - } - - classes = classesToArray( value ); - - if ( classes.length ) { - while ( ( elem = this[ i++ ] ) ) { - curValue = getClass( elem ); - - // This expression is here for better compressibility (see addClass) - cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); - - if ( cur ) { - j = 0; - while ( ( clazz = classes[ j++ ] ) ) { - - // Remove *all* instances - while ( cur.indexOf( " " + clazz + " " ) > -1 ) { - cur = cur.replace( " " + clazz + " ", " " ); - } - } - - // Only assign if different to avoid unneeded rendering. - finalValue = stripAndCollapse( cur ); - if ( curValue !== finalValue ) { - elem.setAttribute( "class", finalValue ); - } - } - } - } - - return this; - }, - - toggleClass: function( value, stateVal ) { - var type = typeof value, - isValidValue = type === "string" || Array.isArray( value ); - - if ( typeof stateVal === "boolean" && isValidValue ) { - return stateVal ? this.addClass( value ) : this.removeClass( value ); - } - - if ( isFunction( value ) ) { - return this.each( function( i ) { - jQuery( this ).toggleClass( - value.call( this, i, getClass( this ), stateVal ), - stateVal - ); - } ); - } - - return this.each( function() { - var className, i, self, classNames; - - if ( isValidValue ) { - - // Toggle individual class names - i = 0; - self = jQuery( this ); - classNames = classesToArray( value ); - - while ( ( className = classNames[ i++ ] ) ) { - - // Check each className given, space separated list - if ( self.hasClass( className ) ) { - self.removeClass( className ); - } else { - self.addClass( className ); - } - } - - // Toggle whole class name - } else if ( value === undefined || type === "boolean" ) { - className = getClass( this ); - if ( className ) { - - // Store className if set - dataPriv.set( this, "__className__", className ); - } - - // If the element has a class name or if we're passed `false`, - // then remove the whole classname (if there was one, the above saved it). - // Otherwise bring back whatever was previously saved (if anything), - // falling back to the empty string if nothing was stored. - if ( this.setAttribute ) { - this.setAttribute( "class", - className || value === false ? - "" : - dataPriv.get( this, "__className__" ) || "" - ); - } - } - } ); - }, - - hasClass: function( selector ) { - var className, elem, - i = 0; - - className = " " + selector + " "; - while ( ( elem = this[ i++ ] ) ) { - if ( elem.nodeType === 1 && - ( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) { - return true; - } - } - - return false; - } -} ); - - - - -var rreturn = /\r/g; - -jQuery.fn.extend( { - val: function( value ) { - var hooks, ret, valueIsFunction, - elem = this[ 0 ]; - - if ( !arguments.length ) { - if ( elem ) { - hooks = jQuery.valHooks[ elem.type ] || - jQuery.valHooks[ elem.nodeName.toLowerCase() ]; - - if ( hooks && - "get" in hooks && - ( ret = hooks.get( elem, "value" ) ) !== undefined - ) { - return ret; - } - - ret = elem.value; - - // Handle most common string cases - if ( typeof ret === "string" ) { - return ret.replace( rreturn, "" ); - } - - // Handle cases where value is null/undef or number - return ret == null ? "" : ret; - } - - return; - } - - valueIsFunction = isFunction( value ); - - return this.each( function( i ) { - var val; - - if ( this.nodeType !== 1 ) { - return; - } - - if ( valueIsFunction ) { - val = value.call( this, i, jQuery( this ).val() ); - } else { - val = value; - } - - // Treat null/undefined as ""; convert numbers to string - if ( val == null ) { - val = ""; - - } else if ( typeof val === "number" ) { - val += ""; - - } else if ( Array.isArray( val ) ) { - val = jQuery.map( val, function( value ) { - return value == null ? "" : value + ""; - } ); - } - - hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; - - // If set returns undefined, fall back to normal setting - if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) { - this.value = val; - } - } ); - } -} ); - -jQuery.extend( { - valHooks: { - option: { - get: function( elem ) { - - var val = jQuery.find.attr( elem, "value" ); - return val != null ? - val : - - // Support: IE <=10 - 11 only - // option.text throws exceptions (#14686, #14858) - // Strip and collapse whitespace - // https://html.spec.whatwg.org/#strip-and-collapse-whitespace - stripAndCollapse( jQuery.text( elem ) ); - } - }, - select: { - get: function( elem ) { - var value, option, i, - options = elem.options, - index = elem.selectedIndex, - one = elem.type === "select-one", - values = one ? null : [], - max = one ? index + 1 : options.length; - - if ( index < 0 ) { - i = max; - - } else { - i = one ? index : 0; - } - - // Loop through all the selected options - for ( ; i < max; i++ ) { - option = options[ i ]; - - // Support: IE <=9 only - // IE8-9 doesn't update selected after form reset (#2551) - if ( ( option.selected || i === index ) && - - // Don't return options that are disabled or in a disabled optgroup - !option.disabled && - ( !option.parentNode.disabled || - !nodeName( option.parentNode, "optgroup" ) ) ) { - - // Get the specific value for the option - value = jQuery( option ).val(); - - // We don't need an array for one selects - if ( one ) { - return value; - } - - // Multi-Selects return an array - values.push( value ); - } - } - - return values; - }, - - set: function( elem, value ) { - var optionSet, option, - options = elem.options, - values = jQuery.makeArray( value ), - i = options.length; - - while ( i-- ) { - option = options[ i ]; - - /* eslint-disable no-cond-assign */ - - if ( option.selected = - jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1 - ) { - optionSet = true; - } - - /* eslint-enable no-cond-assign */ - } - - // Force browsers to behave consistently when non-matching value is set - if ( !optionSet ) { - elem.selectedIndex = -1; - } - return values; - } - } - } -} ); - -// Radios and checkboxes getter/setter -jQuery.each( [ "radio", "checkbox" ], function() { - jQuery.valHooks[ this ] = { - set: function( elem, value ) { - if ( Array.isArray( value ) ) { - return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 ); - } - } - }; - if ( !support.checkOn ) { - jQuery.valHooks[ this ].get = function( elem ) { - return elem.getAttribute( "value" ) === null ? "on" : elem.value; - }; - } -} ); - - - - -// Return jQuery for attributes-only inclusion - - -support.focusin = "onfocusin" in window; - - -var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, - stopPropagationCallback = function( e ) { - e.stopPropagation(); - }; - -jQuery.extend( jQuery.event, { - - trigger: function( event, data, elem, onlyHandlers ) { - - var i, cur, tmp, bubbleType, ontype, handle, special, lastElement, - eventPath = [ elem || document ], - type = hasOwn.call( event, "type" ) ? event.type : event, - namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : []; - - cur = lastElement = tmp = elem = elem || document; - - // Don't do events on text and comment nodes - if ( elem.nodeType === 3 || elem.nodeType === 8 ) { - return; - } - - // focus/blur morphs to focusin/out; ensure we're not firing them right now - if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { - return; - } - - if ( type.indexOf( "." ) > -1 ) { - - // Namespaced trigger; create a regexp to match event type in handle() - namespaces = type.split( "." ); - type = namespaces.shift(); - namespaces.sort(); - } - ontype = type.indexOf( ":" ) < 0 && "on" + type; - - // Caller can pass in a jQuery.Event object, Object, or just an event type string - event = event[ jQuery.expando ] ? - event : - new jQuery.Event( type, typeof event === "object" && event ); - - // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) - event.isTrigger = onlyHandlers ? 2 : 3; - event.namespace = namespaces.join( "." ); - event.rnamespace = event.namespace ? - new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) : - null; - - // Clean up the event in case it is being reused - event.result = undefined; - if ( !event.target ) { - event.target = elem; - } - - // Clone any incoming data and prepend the event, creating the handler arg list - data = data == null ? - [ event ] : - jQuery.makeArray( data, [ event ] ); - - // Allow special events to draw outside the lines - special = jQuery.event.special[ type ] || {}; - if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { - return; - } - - // Determine event propagation path in advance, per W3C events spec (#9951) - // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) - if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) { - - bubbleType = special.delegateType || type; - if ( !rfocusMorph.test( bubbleType + type ) ) { - cur = cur.parentNode; - } - for ( ; cur; cur = cur.parentNode ) { - eventPath.push( cur ); - tmp = cur; - } - - // Only add window if we got to document (e.g., not plain obj or detached DOM) - if ( tmp === ( elem.ownerDocument || document ) ) { - eventPath.push( tmp.defaultView || tmp.parentWindow || window ); - } - } - - // Fire handlers on the event path - i = 0; - while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) { - lastElement = cur; - event.type = i > 1 ? - bubbleType : - special.bindType || type; - - // jQuery handler - handle = ( dataPriv.get( cur, "events" ) || Object.create( null ) )[ event.type ] && - dataPriv.get( cur, "handle" ); - if ( handle ) { - handle.apply( cur, data ); - } - - // Native handler - handle = ontype && cur[ ontype ]; - if ( handle && handle.apply && acceptData( cur ) ) { - event.result = handle.apply( cur, data ); - if ( event.result === false ) { - event.preventDefault(); - } - } - } - event.type = type; - - // If nobody prevented the default action, do it now - if ( !onlyHandlers && !event.isDefaultPrevented() ) { - - if ( ( !special._default || - special._default.apply( eventPath.pop(), data ) === false ) && - acceptData( elem ) ) { - - // Call a native DOM method on the target with the same name as the event. - // Don't do default actions on window, that's where global variables be (#6170) - if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) { - - // Don't re-trigger an onFOO event when we call its FOO() method - tmp = elem[ ontype ]; - - if ( tmp ) { - elem[ ontype ] = null; - } - - // Prevent re-triggering of the same event, since we already bubbled it above - jQuery.event.triggered = type; - - if ( event.isPropagationStopped() ) { - lastElement.addEventListener( type, stopPropagationCallback ); - } - - elem[ type ](); - - if ( event.isPropagationStopped() ) { - lastElement.removeEventListener( type, stopPropagationCallback ); - } - - jQuery.event.triggered = undefined; - - if ( tmp ) { - elem[ ontype ] = tmp; - } - } - } - } - - return event.result; - }, - - // Piggyback on a donor event to simulate a different one - // Used only for `focus(in | out)` events - simulate: function( type, elem, event ) { - var e = jQuery.extend( - new jQuery.Event(), - event, - { - type: type, - isSimulated: true - } - ); - - jQuery.event.trigger( e, null, elem ); - } - -} ); - -jQuery.fn.extend( { - - trigger: function( type, data ) { - return this.each( function() { - jQuery.event.trigger( type, data, this ); - } ); - }, - triggerHandler: function( type, data ) { - var elem = this[ 0 ]; - if ( elem ) { - return jQuery.event.trigger( type, data, elem, true ); - } - } -} ); - - -// Support: Firefox <=44 -// Firefox doesn't have focus(in | out) events -// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787 -// -// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1 -// focus(in | out) events fire after focus & blur events, -// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order -// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857 -if ( !support.focusin ) { - jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) { - - // Attach a single capturing handler on the document while someone wants focusin/focusout - var handler = function( event ) { - jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) ); - }; - - jQuery.event.special[ fix ] = { - setup: function() { - - // Handle: regular nodes (via `this.ownerDocument`), window - // (via `this.document`) & document (via `this`). - var doc = this.ownerDocument || this.document || this, - attaches = dataPriv.access( doc, fix ); - - if ( !attaches ) { - doc.addEventListener( orig, handler, true ); - } - dataPriv.access( doc, fix, ( attaches || 0 ) + 1 ); - }, - teardown: function() { - var doc = this.ownerDocument || this.document || this, - attaches = dataPriv.access( doc, fix ) - 1; - - if ( !attaches ) { - doc.removeEventListener( orig, handler, true ); - dataPriv.remove( doc, fix ); - - } else { - dataPriv.access( doc, fix, attaches ); - } - } - }; - } ); -} -var location = window.location; - -var nonce = { guid: Date.now() }; - -var rquery = ( /\?/ ); - - - -// Cross-browser xml parsing -jQuery.parseXML = function( data ) { - var xml, parserErrorElem; - if ( !data || typeof data !== "string" ) { - return null; - } - - // Support: IE 9 - 11 only - // IE throws on parseFromString with invalid input. - try { - xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" ); - } catch ( e ) {} - - parserErrorElem = xml && xml.getElementsByTagName( "parsererror" )[ 0 ]; - if ( !xml || parserErrorElem ) { - jQuery.error( "Invalid XML: " + ( - parserErrorElem ? - jQuery.map( parserErrorElem.childNodes, function( el ) { - return el.textContent; - } ).join( "\n" ) : - data - ) ); - } - return xml; -}; - - -var - rbracket = /\[\]$/, - rCRLF = /\r?\n/g, - rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, - rsubmittable = /^(?:input|select|textarea|keygen)/i; - -function buildParams( prefix, obj, traditional, add ) { - var name; - - if ( Array.isArray( obj ) ) { - - // Serialize array item. - jQuery.each( obj, function( i, v ) { - if ( traditional || rbracket.test( prefix ) ) { - - // Treat each array item as a scalar. - add( prefix, v ); - - } else { - - // Item is non-scalar (array or object), encode its numeric index. - buildParams( - prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]", - v, - traditional, - add - ); - } - } ); - - } else if ( !traditional && toType( obj ) === "object" ) { - - // Serialize object item. - for ( name in obj ) { - buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); - } - - } else { - - // Serialize scalar item. - add( prefix, obj ); - } -} - -// Serialize an array of form elements or a set of -// key/values into a query string -jQuery.param = function( a, traditional ) { - var prefix, - s = [], - add = function( key, valueOrFunction ) { - - // If value is a function, invoke it and use its return value - var value = isFunction( valueOrFunction ) ? - valueOrFunction() : - valueOrFunction; - - s[ s.length ] = encodeURIComponent( key ) + "=" + - encodeURIComponent( value == null ? "" : value ); - }; - - if ( a == null ) { - return ""; - } - - // If an array was passed in, assume that it is an array of form elements. - if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { - - // Serialize the form elements - jQuery.each( a, function() { - add( this.name, this.value ); - } ); - - } else { - - // If traditional, encode the "old" way (the way 1.3.2 or older - // did it), otherwise encode params recursively. - for ( prefix in a ) { - buildParams( prefix, a[ prefix ], traditional, add ); - } - } - - // Return the resulting serialization - return s.join( "&" ); -}; - -jQuery.fn.extend( { - serialize: function() { - return jQuery.param( this.serializeArray() ); - }, - serializeArray: function() { - return this.map( function() { - - // Can add propHook for "elements" to filter or add form elements - var elements = jQuery.prop( this, "elements" ); - return elements ? jQuery.makeArray( elements ) : this; - } ).filter( function() { - var type = this.type; - - // Use .is( ":disabled" ) so that fieldset[disabled] works - return this.name && !jQuery( this ).is( ":disabled" ) && - rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && - ( this.checked || !rcheckableType.test( type ) ); - } ).map( function( _i, elem ) { - var val = jQuery( this ).val(); - - if ( val == null ) { - return null; - } - - if ( Array.isArray( val ) ) { - return jQuery.map( val, function( val ) { - return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; - } ); - } - - return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; - } ).get(); - } -} ); - - -var - r20 = /%20/g, - rhash = /#.*$/, - rantiCache = /([?&])_=[^&]*/, - rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, - - // #7653, #8125, #8152: local protocol detection - rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, - rnoContent = /^(?:GET|HEAD)$/, - rprotocol = /^\/\//, - - /* Prefilters - * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) - * 2) These are called: - * - BEFORE asking for a transport - * - AFTER param serialization (s.data is a string if s.processData is true) - * 3) key is the dataType - * 4) the catchall symbol "*" can be used - * 5) execution will start with transport dataType and THEN continue down to "*" if needed - */ - prefilters = {}, - - /* Transports bindings - * 1) key is the dataType - * 2) the catchall symbol "*" can be used - * 3) selection will start with transport dataType and THEN go to "*" if needed - */ - transports = {}, - - // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression - allTypes = "*/".concat( "*" ), - - // Anchor tag for parsing the document origin - originAnchor = document.createElement( "a" ); - -originAnchor.href = location.href; - -// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport -function addToPrefiltersOrTransports( structure ) { - - // dataTypeExpression is optional and defaults to "*" - return function( dataTypeExpression, func ) { - - if ( typeof dataTypeExpression !== "string" ) { - func = dataTypeExpression; - dataTypeExpression = "*"; - } - - var dataType, - i = 0, - dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || []; - - if ( isFunction( func ) ) { - - // For each dataType in the dataTypeExpression - while ( ( dataType = dataTypes[ i++ ] ) ) { - - // Prepend if requested - if ( dataType[ 0 ] === "+" ) { - dataType = dataType.slice( 1 ) || "*"; - ( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func ); - - // Otherwise append - } else { - ( structure[ dataType ] = structure[ dataType ] || [] ).push( func ); - } - } - } - }; -} - -// Base inspection function for prefilters and transports -function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { - - var inspected = {}, - seekingTransport = ( structure === transports ); - - function inspect( dataType ) { - var selected; - inspected[ dataType ] = true; - jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { - var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); - if ( typeof dataTypeOrTransport === "string" && - !seekingTransport && !inspected[ dataTypeOrTransport ] ) { - - options.dataTypes.unshift( dataTypeOrTransport ); - inspect( dataTypeOrTransport ); - return false; - } else if ( seekingTransport ) { - return !( selected = dataTypeOrTransport ); - } - } ); - return selected; - } - - return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); -} - -// A special extend for ajax options -// that takes "flat" options (not to be deep extended) -// Fixes #9887 -function ajaxExtend( target, src ) { - var key, deep, - flatOptions = jQuery.ajaxSettings.flatOptions || {}; - - for ( key in src ) { - if ( src[ key ] !== undefined ) { - ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; - } - } - if ( deep ) { - jQuery.extend( true, target, deep ); - } - - return target; -} - -/* Handles responses to an ajax request: - * - finds the right dataType (mediates between content-type and expected dataType) - * - returns the corresponding response - */ -function ajaxHandleResponses( s, jqXHR, responses ) { - - var ct, type, finalDataType, firstDataType, - contents = s.contents, - dataTypes = s.dataTypes; - - // Remove auto dataType and get content-type in the process - while ( dataTypes[ 0 ] === "*" ) { - dataTypes.shift(); - if ( ct === undefined ) { - ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" ); - } - } - - // Check if we're dealing with a known content-type - if ( ct ) { - for ( type in contents ) { - if ( contents[ type ] && contents[ type ].test( ct ) ) { - dataTypes.unshift( type ); - break; - } - } - } - - // Check to see if we have a response for the expected dataType - if ( dataTypes[ 0 ] in responses ) { - finalDataType = dataTypes[ 0 ]; - } else { - - // Try convertible dataTypes - for ( type in responses ) { - if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) { - finalDataType = type; - break; - } - if ( !firstDataType ) { - firstDataType = type; - } - } - - // Or just use first one - finalDataType = finalDataType || firstDataType; - } - - // If we found a dataType - // We add the dataType to the list if needed - // and return the corresponding response - if ( finalDataType ) { - if ( finalDataType !== dataTypes[ 0 ] ) { - dataTypes.unshift( finalDataType ); - } - return responses[ finalDataType ]; - } -} - -/* Chain conversions given the request and the original response - * Also sets the responseXXX fields on the jqXHR instance - */ -function ajaxConvert( s, response, jqXHR, isSuccess ) { - var conv2, current, conv, tmp, prev, - converters = {}, - - // Work with a copy of dataTypes in case we need to modify it for conversion - dataTypes = s.dataTypes.slice(); - - // Create converters map with lowercased keys - if ( dataTypes[ 1 ] ) { - for ( conv in s.converters ) { - converters[ conv.toLowerCase() ] = s.converters[ conv ]; - } - } - - current = dataTypes.shift(); - - // Convert to each sequential dataType - while ( current ) { - - if ( s.responseFields[ current ] ) { - jqXHR[ s.responseFields[ current ] ] = response; - } - - // Apply the dataFilter if provided - if ( !prev && isSuccess && s.dataFilter ) { - response = s.dataFilter( response, s.dataType ); - } - - prev = current; - current = dataTypes.shift(); - - if ( current ) { - - // There's only work to do if current dataType is non-auto - if ( current === "*" ) { - - current = prev; - - // Convert response if prev dataType is non-auto and differs from current - } else if ( prev !== "*" && prev !== current ) { - - // Seek a direct converter - conv = converters[ prev + " " + current ] || converters[ "* " + current ]; - - // If none found, seek a pair - if ( !conv ) { - for ( conv2 in converters ) { - - // If conv2 outputs current - tmp = conv2.split( " " ); - if ( tmp[ 1 ] === current ) { - - // If prev can be converted to accepted input - conv = converters[ prev + " " + tmp[ 0 ] ] || - converters[ "* " + tmp[ 0 ] ]; - if ( conv ) { - - // Condense equivalence converters - if ( conv === true ) { - conv = converters[ conv2 ]; - - // Otherwise, insert the intermediate dataType - } else if ( converters[ conv2 ] !== true ) { - current = tmp[ 0 ]; - dataTypes.unshift( tmp[ 1 ] ); - } - break; - } - } - } - } - - // Apply converter (if not an equivalence) - if ( conv !== true ) { - - // Unless errors are allowed to bubble, catch and return them - if ( conv && s.throws ) { - response = conv( response ); - } else { - try { - response = conv( response ); - } catch ( e ) { - return { - state: "parsererror", - error: conv ? e : "No conversion from " + prev + " to " + current - }; - } - } - } - } - } - } - - return { state: "success", data: response }; -} - -jQuery.extend( { - - // Counter for holding the number of active queries - active: 0, - - // Last-Modified header cache for next request - lastModified: {}, - etag: {}, - - ajaxSettings: { - url: location.href, - type: "GET", - isLocal: rlocalProtocol.test( location.protocol ), - global: true, - processData: true, - async: true, - contentType: "application/x-www-form-urlencoded; charset=UTF-8", - - /* - timeout: 0, - data: null, - dataType: null, - username: null, - password: null, - cache: null, - throws: false, - traditional: false, - headers: {}, - */ - - accepts: { - "*": allTypes, - text: "text/plain", - html: "text/html", - xml: "application/xml, text/xml", - json: "application/json, text/javascript" - }, - - contents: { - xml: /\bxml\b/, - html: /\bhtml/, - json: /\bjson\b/ - }, - - responseFields: { - xml: "responseXML", - text: "responseText", - json: "responseJSON" - }, - - // Data converters - // Keys separate source (or catchall "*") and destination types with a single space - converters: { - - // Convert anything to text - "* text": String, - - // Text to html (true = no transformation) - "text html": true, - - // Evaluate text as a json expression - "text json": JSON.parse, - - // Parse text as xml - "text xml": jQuery.parseXML - }, - - // For options that shouldn't be deep extended: - // you can add your own custom options here if - // and when you create one that shouldn't be - // deep extended (see ajaxExtend) - flatOptions: { - url: true, - context: true - } - }, - - // Creates a full fledged settings object into target - // with both ajaxSettings and settings fields. - // If target is omitted, writes into ajaxSettings. - ajaxSetup: function( target, settings ) { - return settings ? - - // Building a settings object - ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : - - // Extending ajaxSettings - ajaxExtend( jQuery.ajaxSettings, target ); - }, - - ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), - ajaxTransport: addToPrefiltersOrTransports( transports ), - - // Main method - ajax: function( url, options ) { - - // If url is an object, simulate pre-1.5 signature - if ( typeof url === "object" ) { - options = url; - url = undefined; - } - - // Force options to be an object - options = options || {}; - - var transport, - - // URL without anti-cache param - cacheURL, - - // Response headers - responseHeadersString, - responseHeaders, - - // timeout handle - timeoutTimer, - - // Url cleanup var - urlAnchor, - - // Request state (becomes false upon send and true upon completion) - completed, - - // To know if global events are to be dispatched - fireGlobals, - - // Loop variable - i, - - // uncached part of the url - uncached, - - // Create the final options object - s = jQuery.ajaxSetup( {}, options ), - - // Callbacks context - callbackContext = s.context || s, - - // Context for global events is callbackContext if it is a DOM node or jQuery collection - globalEventContext = s.context && - ( callbackContext.nodeType || callbackContext.jquery ) ? - jQuery( callbackContext ) : - jQuery.event, - - // Deferreds - deferred = jQuery.Deferred(), - completeDeferred = jQuery.Callbacks( "once memory" ), - - // Status-dependent callbacks - statusCode = s.statusCode || {}, - - // Headers (they are sent all at once) - requestHeaders = {}, - requestHeadersNames = {}, - - // Default abort message - strAbort = "canceled", - - // Fake xhr - jqXHR = { - readyState: 0, - - // Builds headers hashtable if needed - getResponseHeader: function( key ) { - var match; - if ( completed ) { - if ( !responseHeaders ) { - responseHeaders = {}; - while ( ( match = rheaders.exec( responseHeadersString ) ) ) { - responseHeaders[ match[ 1 ].toLowerCase() + " " ] = - ( responseHeaders[ match[ 1 ].toLowerCase() + " " ] || [] ) - .concat( match[ 2 ] ); - } - } - match = responseHeaders[ key.toLowerCase() + " " ]; - } - return match == null ? null : match.join( ", " ); - }, - - // Raw string - getAllResponseHeaders: function() { - return completed ? responseHeadersString : null; - }, - - // Caches the header - setRequestHeader: function( name, value ) { - if ( completed == null ) { - name = requestHeadersNames[ name.toLowerCase() ] = - requestHeadersNames[ name.toLowerCase() ] || name; - requestHeaders[ name ] = value; - } - return this; - }, - - // Overrides response content-type header - overrideMimeType: function( type ) { - if ( completed == null ) { - s.mimeType = type; - } - return this; - }, - - // Status-dependent callbacks - statusCode: function( map ) { - var code; - if ( map ) { - if ( completed ) { - - // Execute the appropriate callbacks - jqXHR.always( map[ jqXHR.status ] ); - } else { - - // Lazy-add the new callbacks in a way that preserves old ones - for ( code in map ) { - statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; - } - } - } - return this; - }, - - // Cancel the request - abort: function( statusText ) { - var finalText = statusText || strAbort; - if ( transport ) { - transport.abort( finalText ); - } - done( 0, finalText ); - return this; - } - }; - - // Attach deferreds - deferred.promise( jqXHR ); - - // Add protocol if not provided (prefilters might expect it) - // Handle falsy url in the settings object (#10093: consistency with old signature) - // We also use the url parameter if available - s.url = ( ( url || s.url || location.href ) + "" ) - .replace( rprotocol, location.protocol + "//" ); - - // Alias method option to type as per ticket #12004 - s.type = options.method || options.type || s.method || s.type; - - // Extract dataTypes list - s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ]; - - // A cross-domain request is in order when the origin doesn't match the current origin. - if ( s.crossDomain == null ) { - urlAnchor = document.createElement( "a" ); - - // Support: IE <=8 - 11, Edge 12 - 15 - // IE throws exception on accessing the href property if url is malformed, - // e.g. http://example.com:80x/ - try { - urlAnchor.href = s.url; - - // Support: IE <=8 - 11 only - // Anchor's host property isn't correctly set when s.url is relative - urlAnchor.href = urlAnchor.href; - s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !== - urlAnchor.protocol + "//" + urlAnchor.host; - } catch ( e ) { - - // If there is an error parsing the URL, assume it is crossDomain, - // it can be rejected by the transport if it is invalid - s.crossDomain = true; - } - } - - // Convert data if not already a string - if ( s.data && s.processData && typeof s.data !== "string" ) { - s.data = jQuery.param( s.data, s.traditional ); - } - - // Apply prefilters - inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); - - // If request was aborted inside a prefilter, stop there - if ( completed ) { - return jqXHR; - } - - // We can fire global events as of now if asked to - // Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118) - fireGlobals = jQuery.event && s.global; - - // Watch for a new set of requests - if ( fireGlobals && jQuery.active++ === 0 ) { - jQuery.event.trigger( "ajaxStart" ); - } - - // Uppercase the type - s.type = s.type.toUpperCase(); - - // Determine if request has content - s.hasContent = !rnoContent.test( s.type ); - - // Save the URL in case we're toying with the If-Modified-Since - // and/or If-None-Match header later on - // Remove hash to simplify url manipulation - cacheURL = s.url.replace( rhash, "" ); - - // More options handling for requests with no content - if ( !s.hasContent ) { - - // Remember the hash so we can put it back - uncached = s.url.slice( cacheURL.length ); - - // If data is available and should be processed, append data to url - if ( s.data && ( s.processData || typeof s.data === "string" ) ) { - cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data; - - // #9682: remove data so that it's not used in an eventual retry - delete s.data; - } - - // Add or update anti-cache param if needed - if ( s.cache === false ) { - cacheURL = cacheURL.replace( rantiCache, "$1" ); - uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) + - uncached; - } - - // Put hash and anti-cache on the URL that will be requested (gh-1732) - s.url = cacheURL + uncached; - - // Change '%20' to '+' if this is encoded form body content (gh-2658) - } else if ( s.data && s.processData && - ( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) { - s.data = s.data.replace( r20, "+" ); - } - - // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. - if ( s.ifModified ) { - if ( jQuery.lastModified[ cacheURL ] ) { - jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); - } - if ( jQuery.etag[ cacheURL ] ) { - jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); - } - } - - // Set the correct header, if data is being sent - if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { - jqXHR.setRequestHeader( "Content-Type", s.contentType ); - } - - // Set the Accepts header for the server, depending on the dataType - jqXHR.setRequestHeader( - "Accept", - s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? - s.accepts[ s.dataTypes[ 0 ] ] + - ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : - s.accepts[ "*" ] - ); - - // Check for headers option - for ( i in s.headers ) { - jqXHR.setRequestHeader( i, s.headers[ i ] ); - } - - // Allow custom headers/mimetypes and early abort - if ( s.beforeSend && - ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) { - - // Abort if not done already and return - return jqXHR.abort(); - } - - // Aborting is no longer a cancellation - strAbort = "abort"; - - // Install callbacks on deferreds - completeDeferred.add( s.complete ); - jqXHR.done( s.success ); - jqXHR.fail( s.error ); - - // Get transport - transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); - - // If no transport, we auto-abort - if ( !transport ) { - done( -1, "No Transport" ); - } else { - jqXHR.readyState = 1; - - // Send global event - if ( fireGlobals ) { - globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); - } - - // If request was aborted inside ajaxSend, stop there - if ( completed ) { - return jqXHR; - } - - // Timeout - if ( s.async && s.timeout > 0 ) { - timeoutTimer = window.setTimeout( function() { - jqXHR.abort( "timeout" ); - }, s.timeout ); - } - - try { - completed = false; - transport.send( requestHeaders, done ); - } catch ( e ) { - - // Rethrow post-completion exceptions - if ( completed ) { - throw e; - } - - // Propagate others as results - done( -1, e ); - } - } - - // Callback for when everything is done - function done( status, nativeStatusText, responses, headers ) { - var isSuccess, success, error, response, modified, - statusText = nativeStatusText; - - // Ignore repeat invocations - if ( completed ) { - return; - } - - completed = true; - - // Clear timeout if it exists - if ( timeoutTimer ) { - window.clearTimeout( timeoutTimer ); - } - - // Dereference transport for early garbage collection - // (no matter how long the jqXHR object will be used) - transport = undefined; - - // Cache response headers - responseHeadersString = headers || ""; - - // Set readyState - jqXHR.readyState = status > 0 ? 4 : 0; - - // Determine if successful - isSuccess = status >= 200 && status < 300 || status === 304; - - // Get response data - if ( responses ) { - response = ajaxHandleResponses( s, jqXHR, responses ); - } - - // Use a noop converter for missing script but not if jsonp - if ( !isSuccess && - jQuery.inArray( "script", s.dataTypes ) > -1 && - jQuery.inArray( "json", s.dataTypes ) < 0 ) { - s.converters[ "text script" ] = function() {}; - } - - // Convert no matter what (that way responseXXX fields are always set) - response = ajaxConvert( s, response, jqXHR, isSuccess ); - - // If successful, handle type chaining - if ( isSuccess ) { - - // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. - if ( s.ifModified ) { - modified = jqXHR.getResponseHeader( "Last-Modified" ); - if ( modified ) { - jQuery.lastModified[ cacheURL ] = modified; - } - modified = jqXHR.getResponseHeader( "etag" ); - if ( modified ) { - jQuery.etag[ cacheURL ] = modified; - } - } - - // if no content - if ( status === 204 || s.type === "HEAD" ) { - statusText = "nocontent"; - - // if not modified - } else if ( status === 304 ) { - statusText = "notmodified"; - - // If we have data, let's convert it - } else { - statusText = response.state; - success = response.data; - error = response.error; - isSuccess = !error; - } - } else { - - // Extract error from statusText and normalize for non-aborts - error = statusText; - if ( status || !statusText ) { - statusText = "error"; - if ( status < 0 ) { - status = 0; - } - } - } - - // Set data for the fake xhr object - jqXHR.status = status; - jqXHR.statusText = ( nativeStatusText || statusText ) + ""; - - // Success/Error - if ( isSuccess ) { - deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); - } else { - deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); - } - - // Status-dependent callbacks - jqXHR.statusCode( statusCode ); - statusCode = undefined; - - if ( fireGlobals ) { - globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", - [ jqXHR, s, isSuccess ? success : error ] ); - } - - // Complete - completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); - - if ( fireGlobals ) { - globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); - - // Handle the global AJAX counter - if ( !( --jQuery.active ) ) { - jQuery.event.trigger( "ajaxStop" ); - } - } - } - - return jqXHR; - }, - - getJSON: function( url, data, callback ) { - return jQuery.get( url, data, callback, "json" ); - }, - - getScript: function( url, callback ) { - return jQuery.get( url, undefined, callback, "script" ); - } -} ); - -jQuery.each( [ "get", "post" ], function( _i, method ) { - jQuery[ method ] = function( url, data, callback, type ) { - - // Shift arguments if data argument was omitted - if ( isFunction( data ) ) { - type = type || callback; - callback = data; - data = undefined; - } - - // The url can be an options object (which then must have .url) - return jQuery.ajax( jQuery.extend( { - url: url, - type: method, - dataType: type, - data: data, - success: callback - }, jQuery.isPlainObject( url ) && url ) ); - }; -} ); - -jQuery.ajaxPrefilter( function( s ) { - var i; - for ( i in s.headers ) { - if ( i.toLowerCase() === "content-type" ) { - s.contentType = s.headers[ i ] || ""; - } - } -} ); - - -jQuery._evalUrl = function( url, options, doc ) { - return jQuery.ajax( { - url: url, - - // Make this explicit, since user can override this through ajaxSetup (#11264) - type: "GET", - dataType: "script", - cache: true, - async: false, - global: false, - - // Only evaluate the response if it is successful (gh-4126) - // dataFilter is not invoked for failure responses, so using it instead - // of the default converter is kludgy but it works. - converters: { - "text script": function() {} - }, - dataFilter: function( response ) { - jQuery.globalEval( response, options, doc ); - } - } ); -}; - - -jQuery.fn.extend( { - wrapAll: function( html ) { - var wrap; - - if ( this[ 0 ] ) { - if ( isFunction( html ) ) { - html = html.call( this[ 0 ] ); - } - - // The elements to wrap the target around - wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); - - if ( this[ 0 ].parentNode ) { - wrap.insertBefore( this[ 0 ] ); - } - - wrap.map( function() { - var elem = this; - - while ( elem.firstElementChild ) { - elem = elem.firstElementChild; - } - - return elem; - } ).append( this ); - } - - return this; - }, - - wrapInner: function( html ) { - if ( isFunction( html ) ) { - return this.each( function( i ) { - jQuery( this ).wrapInner( html.call( this, i ) ); - } ); - } - - return this.each( function() { - var self = jQuery( this ), - contents = self.contents(); - - if ( contents.length ) { - contents.wrapAll( html ); - - } else { - self.append( html ); - } - } ); - }, - - wrap: function( html ) { - var htmlIsFunction = isFunction( html ); - - return this.each( function( i ) { - jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html ); - } ); - }, - - unwrap: function( selector ) { - this.parent( selector ).not( "body" ).each( function() { - jQuery( this ).replaceWith( this.childNodes ); - } ); - return this; - } -} ); - - -jQuery.expr.pseudos.hidden = function( elem ) { - return !jQuery.expr.pseudos.visible( elem ); -}; -jQuery.expr.pseudos.visible = function( elem ) { - return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length ); -}; - - - - -jQuery.ajaxSettings.xhr = function() { - try { - return new window.XMLHttpRequest(); - } catch ( e ) {} -}; - -var xhrSuccessStatus = { - - // File protocol always yields status code 0, assume 200 - 0: 200, - - // Support: IE <=9 only - // #1450: sometimes IE returns 1223 when it should be 204 - 1223: 204 - }, - xhrSupported = jQuery.ajaxSettings.xhr(); - -support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); -support.ajax = xhrSupported = !!xhrSupported; - -jQuery.ajaxTransport( function( options ) { - var callback, errorCallback; - - // Cross domain only allowed if supported through XMLHttpRequest - if ( support.cors || xhrSupported && !options.crossDomain ) { - return { - send: function( headers, complete ) { - var i, - xhr = options.xhr(); - - xhr.open( - options.type, - options.url, - options.async, - options.username, - options.password - ); - - // Apply custom fields if provided - if ( options.xhrFields ) { - for ( i in options.xhrFields ) { - xhr[ i ] = options.xhrFields[ i ]; - } - } - - // Override mime type if needed - if ( options.mimeType && xhr.overrideMimeType ) { - xhr.overrideMimeType( options.mimeType ); - } - - // X-Requested-With header - // For cross-domain requests, seeing as conditions for a preflight are - // akin to a jigsaw puzzle, we simply never set it to be sure. - // (it can always be set on a per-request basis or even using ajaxSetup) - // For same-domain requests, won't change header if already provided. - if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) { - headers[ "X-Requested-With" ] = "XMLHttpRequest"; - } - - // Set headers - for ( i in headers ) { - xhr.setRequestHeader( i, headers[ i ] ); - } - - // Callback - callback = function( type ) { - return function() { - if ( callback ) { - callback = errorCallback = xhr.onload = - xhr.onerror = xhr.onabort = xhr.ontimeout = - xhr.onreadystatechange = null; - - if ( type === "abort" ) { - xhr.abort(); - } else if ( type === "error" ) { - - // Support: IE <=9 only - // On a manual native abort, IE9 throws - // errors on any property access that is not readyState - if ( typeof xhr.status !== "number" ) { - complete( 0, "error" ); - } else { - complete( - - // File: protocol always yields status 0; see #8605, #14207 - xhr.status, - xhr.statusText - ); - } - } else { - complete( - xhrSuccessStatus[ xhr.status ] || xhr.status, - xhr.statusText, - - // Support: IE <=9 only - // IE9 has no XHR2 but throws on binary (trac-11426) - // For XHR2 non-text, let the caller handle it (gh-2498) - ( xhr.responseType || "text" ) !== "text" || - typeof xhr.responseText !== "string" ? - { binary: xhr.response } : - { text: xhr.responseText }, - xhr.getAllResponseHeaders() - ); - } - } - }; - }; - - // Listen to events - xhr.onload = callback(); - errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" ); - - // Support: IE 9 only - // Use onreadystatechange to replace onabort - // to handle uncaught aborts - if ( xhr.onabort !== undefined ) { - xhr.onabort = errorCallback; - } else { - xhr.onreadystatechange = function() { - - // Check readyState before timeout as it changes - if ( xhr.readyState === 4 ) { - - // Allow onerror to be called first, - // but that will not handle a native abort - // Also, save errorCallback to a variable - // as xhr.onerror cannot be accessed - window.setTimeout( function() { - if ( callback ) { - errorCallback(); - } - } ); - } - }; - } - - // Create the abort callback - callback = callback( "abort" ); - - try { - - // Do send the request (this may raise an exception) - xhr.send( options.hasContent && options.data || null ); - } catch ( e ) { - - // #14683: Only rethrow if this hasn't been notified as an error yet - if ( callback ) { - throw e; - } - } - }, - - abort: function() { - if ( callback ) { - callback(); - } - } - }; - } -} ); - - - - -// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432) -jQuery.ajaxPrefilter( function( s ) { - if ( s.crossDomain ) { - s.contents.script = false; - } -} ); - -// Install script dataType -jQuery.ajaxSetup( { - accepts: { - script: "text/javascript, application/javascript, " + - "application/ecmascript, application/x-ecmascript" - }, - contents: { - script: /\b(?:java|ecma)script\b/ - }, - converters: { - "text script": function( text ) { - jQuery.globalEval( text ); - return text; - } - } -} ); - -// Handle cache's special case and crossDomain -jQuery.ajaxPrefilter( "script", function( s ) { - if ( s.cache === undefined ) { - s.cache = false; - } - if ( s.crossDomain ) { - s.type = "GET"; - } -} ); - -// Bind script tag hack transport -jQuery.ajaxTransport( "script", function( s ) { - - // This transport only deals with cross domain or forced-by-attrs requests - if ( s.crossDomain || s.scriptAttrs ) { - var script, callback; - return { - send: function( _, complete ) { - script = jQuery( " - {% endmacro %} \ No newline at end of file diff --git a/datafusion/contributor-guide/communication.html b/datafusion/contributor-guide/communication.html deleted file mode 100644 index 1dd09622198e..000000000000 --- a/datafusion/contributor-guide/communication.html +++ /dev/null @@ -1,431 +0,0 @@ - - - - - - - - - Communication — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Communication

-

We welcome participation from everyone and encourage you to join us, ask -questions, and get involved.

-

All participation in the Apache Arrow DataFusion project is governed by the -Apache Software Foundation’s code of -conduct.

-

The vast majority of communication occurs in the open on our -github repository.

-
-

Questions?

-
-

Mailing list

-

We use arrow.apache.org’s dev@ mailing list for project management, release -coordination and design discussions -(subscribe, -unsubscribe, -archives).

-

When emailing the dev list, please make sure to prefix the subject line with a -[DataFusion] tag, e.g. "[DataFusion] New API for remote data sources", so -that the appropriate people in the Apache Arrow community notice the message.

-
-
-

Slack and Discord

-

We use the official ASF Slack workspace -for informal discussions and coordination. This is a great place to meet other -contributors and get guidance on where to contribute. Join us in the -#arrow-rust channel.

-

We also have a backup Arrow Rust Discord -server (invite link) in case you are not able -to join the Slack workspace. If you need an invite to the Slack workspace, you -can also ask for one in our Discord server.

-
-
-

Sync up video calls

-

We have biweekly sync calls every other Thursdays at both 04:00 UTC -and 16:00 UTC (starting September 30, 2021) depending on if there are -items on the agenda to discuss and someone being willing to host.

-

Please see the agenda -for the video call link, add topics and to see what others plan to discuss.

-

The goals of these calls are:

-
    -

  1. Help “put a face to the name” of some of other contributors we are working with

    2. -

  2. Discuss / synchronize on the goals and major initiatives from different stakeholders to identify areas where more alignment is needed

    3. -
-

No decisions are made on the call and anything of substance will be discussed on the mailing list or in github issues / google docs.

-

We will send a summary of all sync ups to the dev@arrow.apache.org mailing list.

-
-
-
- - -
- - - -
- - -
-

previous

-

Introduction

-
- - -
-

next

-

Roadmap

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/contributor-guide/index.html b/datafusion/contributor-guide/index.html deleted file mode 100644 index 7e24d81c5ffb..000000000000 --- a/datafusion/contributor-guide/index.html +++ /dev/null @@ -1,714 +0,0 @@ - - - - - - - - - Introduction — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Introduction

-

We welcome and encourage contributions of all kinds, such as:

-
    -

  1. Tickets with issue reports of feature requests

    2. -

  2. Documentation improvements

    3. -

  3. Code (PR or PR Review)

    4. -
-

In addition to submitting new PRs, we have a healthy tradition of community members helping review each other’s PRs. Doing so is a great way to help the community as well as get more familiar with Rust and the relevant codebases.

-

You can find a curated -good-first-issue -list to help you get started.

-
-
-

Pull Requests

-

We welcome pull requests (PRs) from anyone from the community.

-

DataFusion is a very active fast-moving project and we try to review and merge PRs quickly to keep the review backlog down and the pace up. After review and approval, one of the many people with commit access will merge your PR.

-

Review bandwidth is currently our most limited resource, and we highly encourage reviews by the broader community. If you are waiting for your PR to be reviewed, consider helping review other PRs that are waiting. Such review both helps the reviewer to learn the codebase and become more expert, as well as helps identify issues in the PR (such as lack of test coverage), that can be addressed and make future reviews faster and more efficient.

-
-

Merging PRs

-

Since we are a worldwide community, we have contributors in many timezones who review and comment. To ensure anyone who wishes has an opportunity to review a PR, our committers try to ensure that at least 24 hours passes between when a “major” PR is approved and when it is merged.

-

A “major” PR means there is a substantial change in design or a change in the API. Committers apply their best judgment to determine what constitutes a substantial change. A “minor” PR might be merged without a 24 hour delay, again subject to the judgment of the committer. Examples of potential “minor” PRs are:

-
    -

  1. Documentation improvements/additions

    2. -

  2. Small bug fixes

    3. -

  3. Non-controversial build-related changes (clippy, version upgrades etc.)

    4. -

  4. Smaller non-controversial feature additions

    5. -
-
-
-
-

Developer’s guide

-

This section describes how you can get started at developing DataFusion.

-
-

Windows setup

-
wget https://az792536.vo.msecnd.net/vms/VMBuild_20190311/VirtualBox/MSEdge/MSEdge.Win10.VirtualBox.zip
-choco install -y git rustup.install visualcpp-build-tools
-git-bash.exe
-cargo build
-
-
-
-
-

Protoc Installation

-

Compiling DataFusion from sources requires an installed version of the protobuf compiler, protoc.

-

On most platforms this can be installed from your system’s package manager

-
$ apt install -y protobuf-compiler
-$ dnf install -y protobuf-compiler
-$ pacman -S protobuf
-$ brew install protobuf
-
-
-

You will want to verify the version installed is 3.12 or greater, which introduced support for explicit field presence. Older versions may fail to compile.

-
$ protoc --version
-libprotoc 3.12.4
-
-
-

Alternatively a binary release can be downloaded from the Release Page or built from source.

-
-
-

Bootstrap environment

-

DataFusion is written in Rust and it uses a standard rust toolkit:

-
    -

  • cargo build

    • -

  • cargo fmt to format the code

    • -

  • cargo test to test

    • -

  • etc.

    • -
-

Testing setup:

-
    -

  • rustup update stable DataFusion uses the latest stable release of rust

    • -

  • git submodule init

    • -

  • git submodule update

    • -
-

Formatting instructions:

- -

or run them all at once:

- -
-
-

Test Organization

-

DataFusion has several levels of tests in its Test -Pyramid -and tries to follow Testing Organization in the The Book.

-

This section highlights the most important test modules that exist

-
-

Unit tests

-

Tests for the code in an individual module are defined in the same source file with a test module, following Rust convention

-
-
-

Rust Integration Tests

-

There are several tests of the public interface of the DataFusion library in the tests directory.

-

You can run these tests individually using a command such as

-
cargo test -p datafusion --tests sql_integration
-
-
-

One very important test is the sql_integration test which validates DataFusion’s ability to run a large assortment of SQL queries against an assortment of data setups.

-
-
-

sqllogictests Tests

-

The sqllogictests also validate DataFusion SQL against an assortment of data setups.

-

Data Driven tests have many benefits including being easier to write and maintain. We are in the process of migrating sql_integration tests and encourage -you to add new tests using sqllogictests if possible.

-
-
-
-

Benchmarks

-
-

Criterion Benchmarks

-

Criterion is a statistics-driven micro-benchmarking framework used by DataFusion for evaluating the performance of specific code-paths. In particular, the criterion benchmarks help to both guide optimisation efforts, and prevent performance regressions within DataFusion.

-

Criterion integrates with Cargo’s built-in benchmark support and a given benchmark can be run with

-
cargo bench --bench BENCHMARK_NAME
-
-
-

A full list of benchmarks can be found here.

-

cargo-criterion may also be used for more advanced reporting.

-
-

Parquet SQL Benchmarks

-

The parquet SQL benchmarks can be run with

-
 cargo bench --bench parquet_query_sql
-
-
-

These randomly generate a parquet file, and then benchmark queries sourced from parquet_query_sql.sql against it. This can therefore be a quick way to add coverage of particular query and/or data paths.

-

If the environment variable PARQUET_FILE is set, the benchmark will run queries against this file instead of a randomly generated one. This can be useful for performing multiple runs, potentially with different code, against the same source data, or for testing against a custom dataset.

-

The benchmark will automatically remove any generated parquet file on exit, however, if interrupted (e.g. by CTRL+C) it will not. This can be useful for analysing the particular file after the fact, or preserving it to use with PARQUET_FILE in subsequent runs.

-
-
-
-

Upstream Benchmark Suites

-

Instructions and tooling for running upstream benchmark suites against DataFusion can be found in benchmarks.

-

These are valuable for comparative evaluation against alternative Arrow implementations and query engines.

-
-
-
-

How to add a new scalar function

-

Below is a checklist of what you need to do to add a new scalar function to DataFusion:

-
    -

  • Add the actual implementation of the function:

    -
      -

    • here for string functions

      • -

    • here for math functions

      • -

    • here for datetime functions

      • -

    • create a new module here for other functions

      • -
    -
    • -

  • In physical-expr/src, add:

    -
      -

    • a new variant to BuiltinScalarFunction

      • -

    • a new entry to FromStr with the name of the function as called by SQL

      • -

    • a new line in return_type with the expected return type of the function, given an incoming type

      • -

    • a new line in signature with the signature of the function (number and types of its arguments)

      • -

    • a new line in create_physical_expr/create_physical_fun mapping the built-in to the implementation

      • -

    • tests to the function.

      • -
    -
    • -

  • In core/tests/sql, add a new test where the function is called through SQL against well known data and returns the expected result.

    • -

  • In expr/src/expr_fn.rs, add:

    -
      -

    • a new entry of the unary_scalar_expr! macro for the new function.

      • -
    -
    • -
-
-
-

How to add a new aggregate function

-

Below is a checklist of what you need to do to add a new aggregate function to DataFusion:

-
    -

  • Add the actual implementation of an Accumulator and AggregateExpr:

    -
      -

    • here for string functions

      • -

    • here for math functions

      • -

    • here for datetime functions

      • -

    • create a new module here for other functions

      • -
    -
    • -

  • In datafusion/expr/src, add:

    -
      -

    • a new variant to AggregateFunction

      • -

    • a new entry to FromStr with the name of the function as called by SQL

      • -

    • a new line in return_type with the expected return type of the function, given an incoming type

      • -

    • a new line in signature with the signature of the function (number and types of its arguments)

      • -

    • a new line in create_aggregate_expr mapping the built-in to the implementation

      • -

    • tests to the function.

      • -
    -
    • -

  • In tests/sql, add a new test where the function is called through SQL against well known data and returns the expected result.

    • -
-
-
-

How to display plans graphically

-

The query plans represented by LogicalPlan nodes can be graphically -rendered using Graphviz.

-

To do so, save the output of the display_graphviz function to a file.:

-
// Create plan somehow...
-let mut output = File::create("/tmp/plan.dot")?;
-write!(output, "{}", plan.display_graphviz());
-
-
-

Then, use the dot command line tool to render it into a file that -can be displayed. For example, the following command creates a -/tmp/plan.pdf file:

-
dot -Tpdf < /tmp/plan.dot > /tmp/plan.pdf
-
-
-
-
-

Specifications

-

We formalize DataFusion semantics and behaviors through specification -documents. These specifications are useful to be used as references to help -resolve ambiguities during development or code reviews.

-

You are also welcome to propose changes to existing specifications or create -new specifications as you see fit.

-

Here is the list current active specifications:

- -

All specifications are stored in the docs/source/specification folder.

-
-
-

How to format .md document

-

We are using prettier to format .md files.

-

You can either use npm i -g prettier to install it globally or use npx to run it as a standalone binary. Using npx required a working node environment. Upgrading to the latest prettier is recommended (by adding --upgrade to the npm command).

-
$ prettier --version
-2.3.0
-
-
-

After you’ve confirmed your prettier version, you can format all the .md files:

-
prettier -w {datafusion,datafusion-cli,datafusion-examples,dev,docs}/**/*.md
-
-
-
-
- - -
- - - -
- - -
-

previous

-

Frequently Asked Questions

-
- - -
-

next

-

Communication

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/contributor-guide/quarterly_roadmap.html b/datafusion/contributor-guide/quarterly_roadmap.html deleted file mode 100644 index 51f845a906cd..000000000000 --- a/datafusion/contributor-guide/quarterly_roadmap.html +++ /dev/null @@ -1,523 +0,0 @@ - - - - - - - - - Quarterly Roadmap — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Quarterly Roadmap

-

A quarterly roadmap will be published to give the DataFusion community visibility into the priorities of the projects contributors. This roadmap is not binding.

-
-

2022 Q2

-
-

DataFusion Core

-
    -

  • IO Improvements

    -
      -

    • Reading, registering, and writing more file formats from both DataFrame API and SQL

      • -

    • Additional options for IO including partitioning and metadata support

      • -
    -
    • -

  • Work Scheduling

    -
      -

    • Improve predictability, observability and performance of IO and CPU-bound work

      • -

    • Develop a more explicit story for managing parallelism during plan execution

      • -
    -
    • -

  • Memory Management

    -
      -

    • Add more operators for memory limited execution

      • -
    -
    • -

  • Performance

    -
      -

    • Incorporate row-format into operators such as aggregate

      • -

    • Add row-format benchmarks

      • -

    • Explore JIT-compiling complex expressions

      • -

    • Explore LLVM for JIT, with inline Rust functions as the primary goal

      • -

    • Improve performance of Sort and Merge using Row Format / JIT expressions

      • -
    -
    • -

  • Documentation

    -
      -

    • General improvements to DataFusion website

      • -

    • Publish design documents

      • -
    -
    • -

  • Streaming

    -
      -

    • Create StreamProvider trait

      • -
    -
    • -
-
-
-

Ballista

-
    -

  • Make production ready

    -
      -

    • Shuffle file cleanup

      • -

    • Fill functional gaps between DataFusion and Ballista

      • -

    • Improve task scheduling and data exchange efficiency

      • -

    • Better error handling

      -
        -

      • Task failure

        • -

      • Executor lost

        • -

      • Schedule restart

        • -
      -
      • -

    • Improve monitoring and logging

      • -

    • Auto scaling support

      • -
    -
    • -

  • Support for multi-scheduler deployments. Initially for resiliency and fault tolerance but ultimately to support sharding for scalability and more efficient caching.

    • -

  • Executor deployment grouping based on resource allocation

    • -
-
-
-

Extensions (datafusion-contrib)

-
-

DataFusion-Python

-
    -

  • Add missing functionality to DataFrame and SessionContext

    • -

  • Improve documentation

    • -
-
-
-

DataFusion-S3

-
    -

  • Create Python bindings to use with datafusion-python

    • -
-
-
-

DataFusion-Tui

-
    -

  • Create multiple SQL editors

    • -

  • Expose more Context and query metadata

    • -

  • Support new data sources

    -
      -

    • BigTable, HDFS, HTTP APIs

      • -
    -
    • -
-
-
-

DataFusion-BigTable

-
    -

  • Python binding to use with datafusion-python

    • -

  • Timestamp range predicate pushdown

    • -

  • Multi-threaded partition aware execution

    • -

  • Production ready Rust SDK

    • -
-
-
-

DataFusion-Streams

-
    -

  • Create experimental implementation of StreamProvider trait

    • -
-
-
-
-
- - -
- - - -
- - -
-

previous

-

Roadmap

-
- - -
-

next

-

Specifications

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/contributor-guide/roadmap.html b/datafusion/contributor-guide/roadmap.html deleted file mode 100644 index 0e85413f8296..000000000000 --- a/datafusion/contributor-guide/roadmap.html +++ /dev/null @@ -1,540 +0,0 @@ - - - - - - - - - Roadmap — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Roadmap

-

This document describes high level goals of the DataFusion and -Ballista development community. It is not meant to restrict -possibilities, but rather help newcomers understand the broader -context of where the community is headed, and inspire -additional contributions.

-

DataFusion and Ballista are part of the Apache -Arrow project and governed by the Apache -Software Foundation governance model. These projects are entirely -driven by volunteers, and we welcome contributions for items not on -this roadmap. However, before submitting a large PR, we strongly -suggest you start a conversation using a github issue or the -dev@arrow.apache.org mailing list to make review efficient and avoid -surprises.

-
-

DataFusion

-

DataFusion’s goal is to become the embedded query engine of choice -for new analytic applications, by leveraging the unique features of -Rust and Apache Arrow -to provide:

-
    -

  1. Best-in-class single node query performance

    2. -

  2. A Declarative SQL query interface compatible with PostgreSQL

    3. -

  3. A Dataframe API, similar to those offered by Pandas and Spark

    4. -

  4. A Procedural API for programmatically creating and running execution plans

    5. -

  5. High performance, data race free, ergonomic extensibility points at at every layer

    6. -
-
-

Additional SQL Language Features

-
    -

  • Decimal Support #122

    • -

  • Complete support list on status

    • -

  • Timestamp Arithmetic #194

    • -

  • SQL Parser extension point #533

    • -

  • Support for nested structures (fields, lists, structs) #119

    • -

  • Run all queries from the TPCH benchmark (see milestone for more details)

    • -
-
-
-

Query Optimizer

-
    -

  • More sophisticated cost based optimizer for join ordering

    • -

  • Implement advanced query optimization framework (Tokomak) #440

    • -

  • Finer optimizations for group by and aggregate functions

    • -
-
-
-

Datasources

-
    -

  • Better support for reading data from remote filesystems (e.g. S3) without caching it locally #907 #1060

    • -

  • Improve performances of file format datasources (parallelize file listings, async Arrow readers, file chunk prefetching capability…)

    • -
-
-
-

Runtime / Infrastructure

-
    -

  • Migrate to some sort of arrow2 based implementation (see milestone for more details)

    • -

  • Add DataFusion to h2oai/db-benchmark #147

    • -

  • Improve build time #348

    • -
-
-
-

Resource Management

-
    -

  • Finer grain control and limit of runtime memory #587 and CPU usage #54

    • -
-
-
-

Python Interface

-

TBD

-
-
-

DataFusion CLI (datafusion-cli)

-

Note: There are some additional thoughts on a datafusion-cli vision on #1096.

-
    -

  • Better abstraction between REPL parsing and queries so that commands are separated and handled correctly

    • -

  • Connect to the Statistics subsystem and have the cli print out more stats for query debugging, etc.

    • -

  • Improved error handling for interactive use and shell scripting usage

    • -

  • publishing to apt, brew, and possible NuGet registry so that people can use it more easily

    • -

  • adopt a shorter name, like dfcli?

    • -
-
-
-
-

Ballista

-

Ballista is a distributed compute platform based on Apache Arrow and DataFusion. It provides a query scheduler that -breaks a physical plan into stages and tasks and then schedules tasks for execution across the available executors -in the cluster.

-

Having Ballista as part of the DataFusion codebase helps ensure that DataFusion remains suitable for distributed -compute. For example, it helps ensure that physical query plans can be serialized to protobuf format and that they -remain language-agnostic so that executors can be built in languages other than Rust.

-
-

Ballista Roadmap

-
-
-

Move query scheduler into DataFusion

-

The Ballista scheduler has some advantages over DataFusion query execution because it doesn’t try to eagerly execute -the entire query at once but breaks it down into a directionally-acyclic graph (DAG) of stages and executes a -configurable number of stages and tasks concurrently. It should be possible to push some of this logic down to -DataFusion so that the same scheduler can be used to scale across cores in-process and across nodes in a cluster.

-
-
-

Implement execution-time cost-based optimizations based on statistics

-

After the execution of a query stage, accurate statistics are available for the resulting data. These statistics -could be leveraged by the scheduler to optimize the query during execution. For example, when performing a hash join -it is desirable to load the smaller side of the join into memory and in some cases we cannot predict which side will -be smaller until execution time.

-
-
-
- - -
- - - -
- - -
-

previous

-

Communication

-
- - -
-

next

-

Quarterly Roadmap

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/contributor-guide/specification/index.html b/datafusion/contributor-guide/specification/index.html deleted file mode 100644 index 801975f9de0b..000000000000 --- a/datafusion/contributor-guide/specification/index.html +++ /dev/null @@ -1,345 +0,0 @@ - - - - - - - - - Specifications — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- - - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- -
-

Specifications

-
- -
-
- - -
- - - -
- - -
-

previous

-

Quarterly Roadmap

-
- - -
-

next

-

Invariants

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/contributor-guide/specification/invariants.html b/datafusion/contributor-guide/specification/invariants.html deleted file mode 100644 index 12659958a79f..000000000000 --- a/datafusion/contributor-guide/specification/invariants.html +++ /dev/null @@ -1,862 +0,0 @@ - - - - - - - - - Invariants — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Invariants

-

This document enumerates invariants of DataFusion’s logical and physical planes -(functions, and nodes). Some of these invariants are currently not enforced. -This document assumes that the reader is familiar with some of the codebase, -including rust arrow’s RecordBatch and Array.

-
-

Rational

-

DataFusion’s computational model is built on top of a dynamically typed arrow -object, Array, that offers the interface Array::as_any to downcast itself to -its statically typed versions (e.g. Int32Array). DataFusion uses -Array::data_type to perform the respective downcasting on its physical -operations. DataFusion uses a dynamic type system because the queries being -executed are not always known at compile time: they are only known during the -runtime (or query time) of programs built with DataFusion. This document is -built on top of this principle.

-

In dynamically typed interfaces, it is up to developers to enforce type -invariances. This document declares some of these invariants, so that users -know what they can expect from a query in DataFusion, and DataFusion developers -know what they need to enforce at the coding level.

-
-
-

Notation

-
    -

  • Field or physical field: the tuple name, arrow::DataType and nullability flag (a bool whether values can be null), represented in this document by PF(name, type, nullable)

    • -

  • Logical field: Field with a relation name. Represented in this document by LF(relation, name, type, nullable)

    • -

  • Projected plan: plan with projection as the root node.

    • -

  • Logical schema: a vector of logical fields, used by logical plan.

    • -

  • Physical schema: a vector of physical fields, used by both physical plan and Arrow record batch.

    • -
-
-

Logical

-
-

Function

-

An object that knows its valid incoming logical fields and how to derive its -output logical field from its arguments’ logical fields. A functions’ output -field is itself a function of its input fields:

-
logical_field(lf1: LF, lf2: LF, ...) -> LF
-
-
-

Examples:

-
    -

  • plus(a,b) -> LF(None, "{a} Plus {b}", d(a.type,b.type), a.nullable | b.nullable) where d is the function mapping input types to output type (get_supertype in our current implementation).

    • -

  • length(a) -> LF(None, "length({a})", u32, a.nullable)

    • -
-
-
-

Plan

-

A tree composed of other plans and functions (e.g. Projection c1 + c2, c1 - c2 AS sum12; Scan c1 as u32, c2 as u64) -that knows how to derive its schema.

-

Certain plans have a frozen schema (e.g. Scan), while others derive their -schema from their child nodes.

-
-
-

Column

-

An identifier in a logical plan consists of field name and relation name.

-
-
-
-

Physical

-
-

Function

-

An object that knows how to derive its physical field from its arguments’ -physical fields, and also how to actually perform the computation on data. A -functions’ output physical field is a function of its input physical fields:

-
physical_field(PF1, PF2, ...) -> PF
-
-
-

Examples:

-
    -

  • plus(a,b) -> PF("{a} Plus {b}", d(a.type,b.type), a.nullable | b.nullable) where d is a complex function (get_supertype in our current implementation) whose computation is for each element in the columns, sum the two entries together and return it in the same type as the smallest type of both columns.

    • -

  • length(&str) -> PF("length({a})", u32, a.nullable) whose computation is “count number of bytes in the string”.

    • -
-
-
-

Plan

-

A tree (e.g. Projection c1 + c2, c1 - c2 AS sum12; Scan c1 as u32, c2 as u64) -that knows how to derive its metadata and compute itself.

-

Note how the physical plane does not know how to derive field names: field -names are solely a property of the logical plane, as they are not needed in the -physical plane.

-
-
-

Column

-

A type of physical node in a physical plan consists of a field name and unique index.

-
-
-
-

Data Sources’ registry

-

A map of source name/relation -> Schema plus associated properties necessary to read data from it (e.g. file path).

-
-
-

Functions’ registry

-

A map of function name -> logical + physical function.

-
-
-

Physical Planner

-

A function that knows how to derive a physical plan from a logical plan:

-
plan(LogicalPlan) -> PhysicalPlan
-
-
-
-
-

Logical Optimizer

-

A function that accepts a logical plan and returns an (optimized) logical plan -which computes the same results, but in a more efficient manner:

-
optimize(LogicalPlan) -> LogicalPlan
-
-
-
-
-

Physical Optimizer

-

A function that accepts a physical plan and returns an (optimized) physical -plan which computes the same results, but may differ based on the actual -hardware or execution environment being run:

-
optimize(PhysicalPlan) -> PhysicalPlan
-
-
-
-
-

Builder

-

A function that knows how to build a new logical plan from an existing logical -plan and some extra parameters.

-
build(logical_plan, params...) -> logical_plan
-
-
-
-
-
-

Invariants

-

The following subsections describe invariants. Since functions’ output schema -depends on its arguments’ schema (e.g. min, plus), the resulting schema can -only be derived based on a known set of input schemas (TableProvider). -Likewise, schemas of functions depend on the specific registry of functions -registered (e.g. does my_op return u32 or u64?). Thus, in this section, the -wording “same schema” is understood to mean “same schema under a given registry -of data sources and functions”.

-
-

(relation, name) tuples in logical fields and logical columns are unique

-

Every logical field’s (relation, name) tuple in a logical schema MUST be unique. -Every logical column’s (relation, name) tuple in a logical plan MUST be unique.

-

This invariant guarantees that SELECT t1.id, t2.id FROM t1 JOIN t2... -unambiguously selects the field t1.id and t2.id in a logical schema in the -logical plane.

-
-

Responsibility

-

It is the logical builder and optimizer’s responsibility to guarantee this -invariant.

-
-
-

Validation

-

Builder and optimizer MUST error if this invariant is violated on any logical -node that creates a new schema (e.g. scan, projection, aggregation, join, etc.).

-
-
-
-

Physical schema is consistent with data

-

The contents of every Array in every RecordBatch in every partition returned by -a physical plan MUST be consistent with RecordBatch’s schema, in that every -Array in the RecordBatch must be downcastable to its corresponding type -declared in the RecordBatch.

-
-

Responsibility

-

Physical functions MUST guarantee this invariant. This is particularly -important in aggregate functions, whose aggregating type may be different from -the intermediary types during calculations (e.g. sum(i32) -> i64).

-
-
-

Validation

-

Since the validation of this invariant is computationally expensive, execution -contexts CAN validate this invariant. It is acceptable for physical nodes to -panic! if their input does not satisfy this invariant.

-
-
-
-

Physical schema is consistent in physical functions

-

The schema of every Array returned by a physical function MUST match the -DataType reported by the physical function itself.

-

This ensures that when a physical function claims that it returns a type -(e.g. Int32), users can safely downcast its resulting Array to the -corresponding type (e.g. Int32Array), as well as to write data to formats that -have a schema with nullability flag (e.g. parquet).

-
-

Responsibility

-

It is the responsibility of the developer that writes a physical function to -guarantee this invariant.

-

In particular:

-
    -

  • The derived DataType matches the code it uses to build the array for every branch of valid input type combinations.

    • -

  • The nullability flag matches how the values are built.

    • -
-
-
-

Validation

-

Since the validation of this invariant is computationally expensive, execution -contexts CAN validate this invariant.

-
-
-
-

The physical schema is invariant under planning

-

The physical schema derived by a physical plan returned by the planner MUST be -equivalent to the physical schema derived by the logical plan passed to the -planner. Specifically:

-
plan(logical_plan).schema === logical_plan.physical_schema
-
-
-

Logical plan’s physical schema is defined as logical schema with relation -qualifiers stripped for all logical fields:

-
logical_plan.physical_schema = vector[ strip_relation(f) for f in logical_plan.logical_fields ]
-
-
-

This is used to ensure that the physical schema of its (logical) plan is what -it gets in record batches, so that users can rely on the optimized logical plan -to know the resulting physical schema.

-

Note that since a logical plan can be as simple as a single projection with a -single function, Projection f(c1,c2), a corollary of this is that the -physical schema of every logical function -> physical function must be -invariant under planning.

-
-

Responsibility

-

Developers of physical and logical plans and planners MUST guarantee this -invariant for every triplet (logical plan, physical plan, conversion rule).

-
-
-

Validation

-

Planners MUST validate this invariant. In particular they MUST return an error -when, during planning, a physical function’s derived schema does not match the -logical functions’ derived schema.

-
-
-
-

The output schema equals the physical plan schema

-

The schema of every RecordBatch in every partition outputted by a physical plan -MUST be equal to the schema of the physical plan. Specifically:

-
physical_plan.evaluate(batch).schema = physical_plan.schema
-
-
-

Together with other invariants, this ensures that the consumers of record -batches do not need to know the output schema of the physical plan; they can -safely rely on the record batch’s schema to perform downscaling and naming.

-
-

Responsibility

-

Physical nodes MUST guarantee this invariant.

-
-
-

Validation

-

Execution Contexts CAN validate this invariant.

-
-
-
-

Logical schema is invariant under logical optimization

-

The logical schema derived by a projected logical plan returned by the logical -optimizer MUST be equivalent to the logical schema derived by the logical plan -passed to the planner:

-
optimize(logical_plan).schema === logical_plan.schema
-
-
-

This is used to ensure that plans can be optimized without jeopardizing future -referencing logical columns (name and index) or assumptions about their -schemas.

-
-

Responsibility

-

Logical optimizers MUST guarantee this invariant.

-
-
-

Validation

-

Users of logical optimizers SHOULD validate this invariant.

-
-
-
-

Physical schema is invariant under physical optimization

-

The physical schema derived by a projected physical plan returned by the -physical optimizer MUST match the physical schema derived by the physical plan -passed to the planner:

-
optimize(physical_plan).schema === physical_plan.schema
-
-
-

This is used to ensure that plans can be optimized without jeopardizing future -references of logical columns (name and index) or assumptions about their -schemas.

-
-

Responsibility

-

Optimizers MUST guarantee this invariant.

-
-
-

Validation

-

Users of optimizers SHOULD validate this invariant.

-
-
-
-
- - -
- - - -
- - -
-

previous

-

Specifications

-
- - -
-

next

-

Output field name semantics

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/contributor-guide/specification/output-field-name-semantic.html b/datafusion/contributor-guide/specification/output-field-name-semantic.html deleted file mode 100644 index c8ad47edd847..000000000000 --- a/datafusion/contributor-guide/specification/output-field-name-semantic.html +++ /dev/null @@ -1,780 +0,0 @@ - - - - - - - - - Output field name semantics — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Output field name semantics

-

This specification documents how field names in output record batches should be -generated based on given user queries. The filed name rules apply to -DataFusion queries planned from both SQL queries and Dataframe APIs.

-
-

Field name rules

-
    -

  • All bare column field names MUST not contain relation/table qualifier.

    -
      -

    • Both SELECT t1.id, SELECT id and df.select_columns(&["id"]) SHOULD result in field name: id

      • -
    -
    • -

  • All compound column field names MUST contain relation/table qualifier.

    -
      -

    • SELECT foo + bar SHOULD result in field name: table.foo PLUS table.bar

      • -
    -
    • -

  • Function names MUST be converted to lowercase.

    -
      -

    • SELECT AVG(c1) SHOULD result in field name: avg(table.c1)

      • -
    -
    • -

  • Literal string MUST not be wrapped with quotes or double quotes.

    -
      -

    • SELECT 'foo' SHOULD result in field name: foo

      • -
    -
    • -

  • Operator expressions MUST be wrapped with parentheses.

    -
      -

    • SELECT -2 SHOULD result in field name: (- 2)

      • -
    -
    • -

  • Operator and operand MUST be separated by spaces.

    -
      -

    • SELECT 1+2 SHOULD result in field name: (1 + 2)

      • -
    -
    • -

  • Function arguments MUST be separated by a comma , and a space.

    -
      -

    • SELECT f(c1,c2) and df.select(vec![f.udf("f")?.call(vec![col("c1"), col("c2")])]) SHOULD result in field name: f(table.c1, table.c2)

      • -
    -
    • -
-
-
-

Appendices

-
-

Examples and comparison with other systems

-

Data schema for test sample queries:

-
CREATE TABLE t1 (id INT, a VARCHAR(5));
-INSERT INTO t1 (id, a) VALUES (1, 'foo');
-INSERT INTO t1 (id, a) VALUES (2, 'bar');
-
-CREATE TABLE t2 (id INT, b VARCHAR(5));
-INSERT INTO t2 (id, b) VALUES (1, 'hello');
-INSERT INTO t2 (id, b) VALUES (2, 'world');
-
-
-
-

Projected columns

-

Query:

-
SELECT t1.id, a, t2.id, b
-FROM t1
-JOIN t2 ON t1.id = t2.id
-
-
-

DataFusion Arrow record batches output:

- - - - - - - - - - - - - - - - - - - - -

id

a

id

b

1

foo

1

hello

2

bar

2

world

-

Spark, MySQL 8 and PostgreSQL 13 output:

- - - - - - - - - - - - - - - - - - - - -

id

a

id

b

1

foo

1

hello

2

bar

2

world

-

SQLite 3 output:

- - - - - - - - - - - - - - - - - -

id

a

b

1

foo

hello

2

bar

world

-
-
-

Function transformed columns

-

Query:

-
SELECT ABS(t1.id), abs(-id) FROM t1;
-
-
-

DataFusion Arrow record batches output:

- - - - - - - - - - - - - - -

abs(t1.id)

abs((- t1.id))

1

1

2

2

-

Spark output:

- - - - - - - - - - - - - - -

abs(id)

abs((- id))

1

1

2

2

-

MySQL 8 output:

- - - - - - - - - - - - - - -

ABS(t1.id)

abs(-id)

1

1

2

2

-

PostgreSQL 13 output:

- - - - - - - - - - - - - - -

abs

abs

1

1

2

2

-

SQlite 3 output:

- - - - - - - - - - - - - - -

ABS(t1.id)

abs(-id)

1

1

2

2

-
-
-

Function with operators

-

Query:

-
SELECT t1.id + ABS(id), ABS(id * t1.id) FROM t1;
-
-
-

DataFusion Arrow record batches output:

- - - - - - - - - - - - - - -

t1.id + abs(t1.id)

abs(t1.id * t1.id)

2

1

4

4

-

Spark output:

- - - - - - - - - - - - - - -

id + abs(id)

abs(id * id)

2

1

4

4

-

MySQL 8 output:

- - - - - - - - - - - - - - -

t1.id + ABS(id)

ABS(id * t1.id)

2

1

4

4

-

PostgreSQL output:

- - - - - - - - - - - - - - -

?column?

abs

2

1

4

4

-

SQLite output:

- - - - - - - - - - - - - - -

t1.id + ABS(id)

ABS(id * t1.id)

2

1

4

4

-
-
-

Project literals

-

Query:

-
SELECT 1, 2+5, 'foo_bar';
-
-
-

DataFusion Arrow record batches output:

- - - - - - - - - - - - - -

1

(2 + 5)

foo_bar

1

7

foo_bar

-

Spark output:

- - - - - - - - - - - - - -

1

(2 + 5)

foo_bar

1

7

foo_bar

-

MySQL output:

- - - - - - - - - - - - - -

1

2+5

foo_bar

1

7

foo_bar

-

PostgreSQL output:

- - - - - - - - - - - - - -

?column?

?column?

?column?

1

7

foo_bar

-

SQLite 3 output:

- - - - - - - - - - - - - -

1

2+5

‘foo_bar’

1

7

foo_bar

-
-
-
-
- - -
- - - -
- - -
-

previous

-

Invariants

-
- -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/genindex.html b/datafusion/genindex.html deleted file mode 100644 index d11cc3e03f78..000000000000 --- a/datafusion/genindex.html +++ /dev/null @@ -1,304 +0,0 @@ - - - - - - - - Index — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- -
- - - - - - -
- -
- - -

Index

- -
- -
- - -
- - - -
-
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/index.html b/datafusion/index.html deleted file mode 100644 index de927a4309be..000000000000 --- a/datafusion/index.html +++ /dev/null @@ -1,405 +0,0 @@ - - - - - - - - - Apache Arrow DataFusion — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- -
-

Apache Arrow DataFusion

-
-

Table of Contents

- - -
-
- - -
- - - -
- -
-

next

-

Introduction

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/objects.inv b/datafusion/objects.inv deleted file mode 100644 index 6afe2f127eae..000000000000 Binary files a/datafusion/objects.inv and /dev/null differ diff --git a/datafusion/search.html b/datafusion/search.html deleted file mode 100644 index 027b85be5289..000000000000 --- a/datafusion/search.html +++ /dev/null @@ -1,333 +0,0 @@ - - - - - - - - Search — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- -
- - - - - - -
- -
- -

Search

- - - - -

- Searching for multiple words only shows matches that contain - all words. -

- - -
- - - -
- - - -
- -
- - -
- - - -
-
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/searchindex.js b/datafusion/searchindex.js deleted file mode 100644 index 8410fe40b0c5..000000000000 --- a/datafusion/searchindex.js +++ /dev/null @@ -1 +0,0 @@ -Search.setIndex({"docnames": ["contributor-guide/communication", "contributor-guide/index", "contributor-guide/quarterly_roadmap", "contributor-guide/roadmap", "contributor-guide/specification/index", "contributor-guide/specification/invariants", "contributor-guide/specification/output-field-name-semantic", "index", "user-guide/cli", "user-guide/configs", "user-guide/dataframe", "user-guide/example-usage", "user-guide/expressions", "user-guide/faq", "user-guide/introduction", "user-guide/library", "user-guide/sql/aggregate_functions", "user-guide/sql/data_types", "user-guide/sql/ddl", "user-guide/sql/explain", "user-guide/sql/index", "user-guide/sql/information_schema", "user-guide/sql/scalar_functions", "user-guide/sql/select", "user-guide/sql/sql_status", "user-guide/sql/subqueries"], "filenames": ["contributor-guide/communication.md", "contributor-guide/index.md", "contributor-guide/quarterly_roadmap.md", "contributor-guide/roadmap.md", "contributor-guide/specification/index.rst", "contributor-guide/specification/invariants.md", "contributor-guide/specification/output-field-name-semantic.md", "index.rst", "user-guide/cli.md", "user-guide/configs.md", "user-guide/dataframe.md", "user-guide/example-usage.md", "user-guide/expressions.md", "user-guide/faq.md", "user-guide/introduction.md", "user-guide/library.md", "user-guide/sql/aggregate_functions.md", "user-guide/sql/data_types.md", "user-guide/sql/ddl.md", "user-guide/sql/explain.md", "user-guide/sql/index.rst", "user-guide/sql/information_schema.md", "user-guide/sql/scalar_functions.md", "user-guide/sql/select.md", "user-guide/sql/sql_status.md", "user-guide/sql/subqueries.md"], "titles": ["Communication", "Introduction", "Quarterly Roadmap", "Roadmap", "Specifications", "Invariants", "Output field name semantics", "Apache Arrow DataFusion", "DataFusion Command-line SQL Utility", "Configuration Settings", "DataFrame API", "Example Usage", "Expressions", "Frequently Asked Questions", "Introduction", "Using DataFusion as a library", "Aggregate Functions", "Data Types", "DDL", "EXPLAIN", "SQL Reference", "Information Schema", "Scalar Functions", "SELECT syntax", "Status", "Subqueries"], "terms": {"we": [0, 1, 3, 15, 23], "welcom": [0, 1, 3], "particip": 0, "from": [0, 1, 2, 3, 5, 6, 8, 9, 10, 15, 17, 18, 19, 20, 21, 22, 24, 25], "everyon": 0, "encourag": [0, 1], "you": [0, 1, 3, 8, 9, 11, 15, 16, 17, 19, 23], "join": [0, 3, 5, 6, 9, 10, 20, 24], "u": [0, 8], "ask": [0, 7], "get": [0, 1, 5, 10, 15], "involv": 0, "all": [0, 1, 3, 5, 6, 8, 10, 11, 12, 15, 21, 22, 23, 24, 25], "apach": [0, 3, 8, 14], "arrow": [0, 1, 3, 5, 6, 8, 14, 17, 22], "datafus": [0, 1, 5, 6, 9, 10, 11, 16, 17, 18, 21, 23, 25], "project": [0, 1, 2, 3, 5, 10, 19, 24], "i": [0, 1, 2, 3, 8, 9, 10, 11, 12, 14, 15, 16, 17, 18, 22, 23, 25], "govern": [0, 3], "softwar": [0, 3, 8], "foundat": [0, 3, 14], "": [0, 3, 5, 7, 8, 9, 10, 14, 18, 25], "code": [0, 1, 5, 7], "conduct": [0, 7], "The": [0, 1, 3, 6, 8, 9, 10, 17, 18, 19, 22, 23, 25], "vast": 0, "major": [0, 1], "occur": [0, 17], "open": 0, "our": [0, 1, 5], "github": [0, 3, 8], "repositori": [0, 8], "us": [0, 1, 2, 3, 5, 7, 9, 10, 12, 13, 16, 17, 18, 19, 21, 22, 23, 25], "org": [0, 3, 8], "dev": [0, 1, 3, 8], "manag": [0, 1, 2], "releas": [0, 1, 15], "coordin": 0, "design": [0, 1, 2, 13, 14, 15], "discuss": 0, "subscrib": 0, "unsubscrib": 0, "archiv": 0, "when": [0, 1, 3, 5, 9, 10, 12, 17, 22, 23], "email": 0, "pleas": [0, 11, 16, 23], "make": [0, 1, 2, 3, 23], "sure": [0, 23], "prefix": 0, "subject": [0, 1], "line": [0, 1, 7], "tag": [0, 8], "e": [0, 1, 3, 5, 9, 16], "g": [0, 1, 3, 5, 9, 16], "new": [0, 2, 3, 5, 7, 9, 10, 11], "api": [0, 1, 2, 3, 6, 7, 12, 14], "remot": [0, 3], "data": [0, 1, 2, 3, 6, 9, 10, 12, 13, 14, 16, 18, 20, 22, 23], "sourc": [0, 1, 2, 14, 15, 18, 19, 20, 22], "so": [0, 1, 3, 5, 8, 9, 10, 11], "appropri": [0, 8], "peopl": [0, 1, 3], "notic": 0, "messag": [0, 9], "offici": [0, 8], "asf": 0, "workspac": 0, "inform": [0, 8, 9, 18, 19, 20], "thi": [0, 1, 2, 3, 5, 6, 8, 9, 10, 11, 12, 13, 15, 17, 21, 22, 23], "great": [0, 1], "place": 0, "meet": 0, "other": [0, 1, 3, 5, 8, 15, 20, 24], "contributor": [0, 1, 2], "guidanc": 0, "where": [0, 1, 3, 5, 10, 12, 16, 20, 24, 25], "contribut": [0, 1, 3], "rust": [0, 2, 3, 5, 7, 12, 14], "channel": 0, "also": [0, 1, 5, 8, 9, 13, 18, 22], "have": [0, 1, 3, 5, 10, 20, 24], "backup": 0, "server": 0, "invit": 0, "link": 0, "case": [0, 3, 8, 9, 11, 12, 23, 24], "ar": [0, 1, 3, 8, 9, 10, 11, 12, 15, 16, 17, 18, 22, 23, 25], "abl": 0, "If": [0, 1, 9, 18, 19], "need": [0, 1, 5, 8, 14, 19, 22], "an": [0, 1, 5, 8, 10, 14, 15, 16, 18, 22, 25], "can": [0, 1, 3, 5, 8, 9, 10, 12, 14, 15, 16, 17, 18, 21, 22, 23, 25], "one": [0, 1, 9, 10, 12, 25], "biweekli": 0, "everi": [0, 3, 5, 23], "thursdai": 0, "both": [0, 1, 2, 5, 6, 14, 23], "04": 0, "00": [0, 9, 22], "utc": [0, 8, 21, 22], "16": [0, 19], "start": [0, 1, 3, 15], "septemb": 0, "30": 0, "2021": [0, 18], "depend": [0, 5, 15], "item": [0, 3], "agenda": 0, "someon": 0, "being": [0, 1, 5], "willing": 0, "host": 0, "see": [0, 1, 3, 8, 17, 23], "add": [0, 2, 3, 7, 9, 10, 11, 15], "topic": 0, "what": [0, 1, 5, 9, 22], "plan": [0, 2, 3, 6, 7, 9, 10, 11, 14, 15, 19, 22], "goal": [0, 2, 3], "help": [0, 1, 3, 8, 9], "put": [0, 11], "face": 0, "name": [0, 1, 3, 4, 7, 8, 9, 10, 11, 19, 21, 22, 23], "some": [0, 3, 5, 9, 10, 11, 12], "work": [0, 1, 2, 8, 9, 11, 14], "synchron": 0, "initi": [0, 2], "differ": [0, 1, 5, 9, 25], "stakehold": 0, "identifi": [0, 1, 5, 7, 22], "area": 0, "more": [0, 1, 2, 3, 5, 8, 9, 12, 16, 19, 23, 25], "align": 0, "No": 0, "decis": 0, "made": [0, 11, 23], "anyth": 0, "substanc": 0, "issu": [0, 1, 3, 7], "googl": 0, "doc": [0, 1, 8, 10, 15], "send": 0, "summari": 0, "kind": 1, "ticket": 1, "report": [1, 5], "featur": [1, 15], "improv": [1, 2, 3], "review": [1, 3], "In": [1, 5, 11, 12, 23], "addit": [1, 2, 9, 10, 12], "submit": [1, 3], "healthi": 1, "tradit": 1, "commun": [1, 2, 3, 7], "member": 1, "each": [1, 5, 8, 9, 10], "do": [1, 5, 9, 15], "wai": [1, 8, 22], "well": [1, 5, 8, 10, 14, 15], "familiar": [1, 5], "relev": 1, "codebas": [1, 3, 5], "find": [1, 25], "curat": 1, "good": 1, "first": [1, 9, 12, 15, 22], "list": [1, 3, 8, 9, 12, 16, 18, 24], "anyon": 1, "veri": [1, 14], "activ": 1, "fast": [1, 14], "move": 1, "try": [1, 3, 8, 9, 19], "quickli": [1, 14], "keep": 1, "backlog": 1, "down": [1, 3, 9, 24], "pace": 1, "up": [1, 5, 10], "after": [1, 3, 9, 10, 15, 23], "approv": 1, "mani": [1, 12, 25], "commit": 1, "access": [1, 9, 21], "your": [1, 8, 11, 14, 15], "bandwidth": 1, "current": [1, 5, 8, 9, 12, 15, 17, 21, 22], "most": 1, "limit": [1, 2, 3, 10, 11, 19, 20, 24], "resourc": [1, 2], "highli": [1, 9], "broader": [1, 3], "wait": 1, "consid": [1, 11], "Such": 1, "learn": 1, "becom": [1, 3], "expert": 1, "lack": 1, "coverag": 1, "address": 1, "futur": [1, 5], "faster": 1, "effici": [1, 2, 3, 5, 9, 14], "sinc": [1, 5, 9, 22], "worldwid": 1, "timezon": [1, 22], "who": 1, "comment": 1, "To": [1, 9, 11, 15, 21], "ensur": [1, 3, 5], "wish": 1, "ha": [1, 3, 9, 10, 11], "opportun": 1, "committ": 1, "least": [1, 15], "24": 1, "hour": [1, 9, 22], "pass": [1, 5, 9, 15], "between": [1, 2, 3, 9, 16], "A": [1, 2, 3, 5, 10, 11, 16, 23, 25], "mean": [1, 5, 10, 16], "substanti": 1, "chang": [1, 23], "appli": [1, 6, 9, 10], "best": [1, 3], "judgment": 1, "determin": [1, 9], "constitut": 1, "minor": 1, "might": 1, "without": [1, 3, 5, 8], "delai": 1, "again": 1, "exampl": [1, 3, 5, 7, 9, 10, 12, 15, 17, 23, 25], "potenti": 1, "small": [1, 9], "bug": 1, "fix": 1, "non": [1, 9, 23], "controversi": 1, "build": [1, 3, 5, 8, 10, 14, 15, 16], "relat": [1, 6, 25], "clippi": 1, "version": [1, 5, 8], "upgrad": 1, "etc": [1, 3, 5], "smaller": [1, 3], "section": [1, 5, 15], "describ": [1, 3, 5, 8, 10, 23], "wget": 1, "http": [1, 2, 8], "az792536": 1, "vo": 1, "msecnd": 1, "net": 1, "vm": 1, "vmbuild_20190311": 1, "virtualbox": 1, "msedg": 1, "win10": 1, "zip": 1, "choco": 1, "y": [1, 12, 23, 25], "git": [1, 8], "rustup": [1, 15], "visualcpp": 1, "tool": [1, 8], "bash": 1, "ex": [1, 11], "cargo": [1, 15], "compil": [1, 2, 5, 15], "requir": [1, 9, 15], "protobuf": [1, 3], "On": 1, "platform": [1, 3, 13], "system": [1, 5, 9, 14, 16, 17], "packag": 1, "apt": [1, 3], "dnf": 1, "pacman": 1, "brew": [1, 3, 8], "want": [1, 14, 15, 23], "verifi": 1, "3": [1, 6, 8, 9, 18, 22], "12": [1, 8, 18, 22], "greater": [1, 12, 22], "which": [1, 3, 5, 9, 13, 14, 16, 23], "introduc": 1, "support": [1, 2, 3, 8, 9, 14, 16, 17, 20, 21, 22, 23, 25], "explicit": [1, 2], "field": [1, 3, 4, 7, 22, 23], "presenc": 1, "older": [1, 15], "mai": [1, 5, 8, 9], "fail": [1, 9], "libprotoc": 1, "4": [1, 6, 8, 18, 22], "altern": 1, "binari": [1, 20], "download": [1, 8], "page": [1, 9], "built": [1, 3, 5, 8, 13], "written": [1, 9, 14], "standard": [1, 13, 16, 22], "toolkit": 1, "fmt": 1, "updat": [1, 15], "stabl": [1, 15], "latest": [1, 8, 15], "submodul": 1, "init": 1, "instruct": [1, 15], "ci": 1, "script": [1, 3], "rust_fmt": 1, "sh": 1, "rust_clippi": 1, "rust_toml_fmt": 1, "run": [1, 3, 5, 9, 13, 15], "them": [1, 10, 23], "onc": [1, 3], "rust_lint": 1, "sever": [1, 15], "level": [1, 3, 5, 9], "its": [1, 5, 8, 10, 12, 14, 22], "pyramid": 1, "tri": 1, "follow": [1, 5, 8, 9, 10, 11, 15, 17, 23, 25], "book": 1, "highlight": 1, "import": [1, 5, 10, 15], "modul": 1, "exist": [1, 5, 12, 18, 20], "individu": 1, "defin": [1, 5, 8, 15, 17, 23], "same": [1, 3, 5, 9, 10, 22], "file": [1, 2, 3, 5, 6, 9, 11, 14, 15, 18], "convent": 1, "There": [1, 3, 8], "public": [1, 9, 21], "interfac": [1, 5, 14], "librari": [1, 7, 13], "directori": [1, 8, 15], "command": [1, 3, 7, 17, 19, 21], "p": [1, 8, 16], "sql_integr": 1, "One": [1, 9], "valid": [1, 22], "abil": 1, "larg": [1, 3], "assort": 1, "queri": [1, 2, 5, 6, 9, 10, 13, 14, 15, 16, 17, 18, 23, 24, 25], "against": [1, 8, 15, 23], "driven": [1, 3], "benefit": 1, "includ": [1, 2, 5, 10, 23], "easier": 1, "write": [1, 2, 5, 10], "maintain": [1, 10], "process": [1, 3, 9, 13, 14], "migrat": [1, 3], "possibl": [1, 3, 8, 18], "statist": [1, 9, 20], "micro": 1, "framework": [1, 3, 14], "evalu": [1, 5, 9, 10], "perform": [1, 2, 3, 5, 9, 10, 11, 12, 13, 14, 17, 22], "path": [1, 5, 8, 18, 19], "particular": [1, 5], "optimis": 1, "effort": 1, "prevent": 1, "regress": 1, "within": [1, 13], "given": [1, 5, 6, 25], "bench": 1, "benchmark_nam": 1, "full": [1, 24], "found": [1, 25], "here": [1, 10, 12, 22, 25], "advanc": [1, 3], "parquet_query_sql": 1, "These": [1, 3, 10, 12], "randomli": 1, "gener": [1, 2, 6, 20], "therefor": 1, "quick": 1, "variabl": [1, 8, 9], "parquet_fil": 1, "set": [1, 5, 7, 8, 10, 15, 16, 17, 21, 24, 25], "instead": [1, 8, 9], "multipl": [1, 2, 9], "custom": [1, 15, 17, 24], "dataset": 1, "automat": [1, 9], "remov": [1, 18], "ani": [1, 5, 8, 9, 10, 14, 17], "exit": [1, 8], "howev": [1, 3, 22], "interrupt": 1, "ctrl": 1, "c": [1, 8, 11, 15, 23], "analys": 1, "fact": 1, "preserv": [1, 10], "subsequ": 1, "valuabl": 1, "compar": 1, "implement": [1, 2, 5, 12], "engin": [1, 3, 8, 14, 16], "below": [1, 8, 9, 12, 15, 25], "checklist": 1, "actual": [1, 5, 10], "string": [1, 5, 6, 17, 20, 24], "math": [1, 20, 24], "datetim": [1, 9, 17], "creat": [1, 2, 3, 5, 6, 8, 9, 10, 11, 12, 14, 17, 20, 24], "physic": [1, 3, 9, 19], "expr": [1, 12, 19], "src": [1, 15], "variant": 1, "builtinscalarfunct": 1, "entri": [1, 5], "fromstr": 1, "call": [1, 6, 10], "return_typ": 1, "expect": [1, 5, 16], "return": [1, 5, 10, 12, 16, 22, 23], "type": [1, 5, 9, 10, 20, 22, 24], "incom": [1, 5], "signatur": 1, "number": [1, 3, 5, 9, 10, 16, 23], "argument": [1, 5, 6, 12, 22], "create_physical_expr": 1, "create_physical_fun": 1, "map": [1, 5, 17], "core": [1, 3, 8, 9], "through": 1, "known": [1, 5], "result": [1, 3, 5, 6, 8, 9, 10, 11, 15, 16, 18, 23, 25], "expr_fn": 1, "r": [1, 8, 10, 15, 17], "unary_scalar_expr": 1, "macro": 1, "accumul": 1, "aggregateexpr": 1, "aggregatefunct": 1, "create_aggregate_expr": 1, "repres": [1, 5, 10], "logicalplan": [1, 5, 15], "node": [1, 3, 5, 15], "render": 1, "graphviz": 1, "save": 1, "output": [1, 4, 7, 9, 10, 19, 22], "display_graphviz": 1, "somehow": 1, "let": [1, 10, 11, 15], "mut": 1, "tmp": [1, 19], "dot": 1, "Then": [1, 15], "For": [1, 3, 8, 9, 15, 17], "pdf": 1, "tpdf": 1, "formal": 1, "semant": [1, 4, 7], "behavior": [1, 11], "refer": [1, 5, 7, 10, 12, 16, 23], "resolv": 1, "ambigu": 1, "dure": [1, 2, 3, 5, 9, 16], "propos": 1, "fit": 1, "invari": [1, 4, 7], "store": [1, 8, 9, 16, 18], "folder": 1, "prettier": 1, "either": [1, 10, 23], "npm": 1, "global": [1, 9], "npx": 1, "standalon": 1, "recommend": 1, "ad": [1, 23], "2": [1, 6, 8, 11, 12, 15, 18, 19, 22, 23, 25], "0": [1, 8, 9, 10, 11, 12, 15, 16, 19, 22, 23, 25], "ve": 1, "confirm": 1, "w": [1, 16], "cli": [1, 8, 9], "publish": [2, 3, 8, 15], "give": [2, 23], "visibl": 2, "prioriti": 2, "bind": 2, "io": [2, 8, 15], "read": [2, 3, 5, 9], "regist": [2, 5, 11, 15, 18], "format": [2, 3, 5, 7, 8, 9, 10, 14], "datafram": [2, 3, 6, 7, 12, 14], "sql": [2, 6, 7, 9, 12, 14, 15, 16, 17, 18, 19, 21, 22, 23], "option": [2, 9, 10, 21], "partit": [2, 5, 9, 10, 14, 18, 19, 24], "metadata": [2, 5, 9, 21], "schedul": 2, "predict": [2, 3], "observ": 2, "cpu": [2, 3, 9, 15], "bound": 2, "develop": [2, 3, 5, 7], "stori": 2, "parallel": [2, 3, 9, 13, 14, 24], "execut": [2, 5, 8, 9, 10, 11, 13, 14, 15, 17, 18, 19, 21, 24], "memori": [2, 3, 9, 10, 13, 14, 15, 16, 18], "oper": [2, 5, 9, 13, 16, 17, 22, 24], "incorpor": 2, "row": [2, 8, 9, 10, 18, 23, 25], "aggreg": [2, 3, 5, 7, 9, 10, 11, 15, 19, 20, 24], "benchmark": [2, 3, 7], "explor": 2, "jit": 2, "complex": [2, 5], "express": [2, 6, 7, 9, 10, 16, 17, 20, 23, 24, 25], "llvm": 2, "inlin": 2, "function": [2, 3, 7, 8, 9, 10, 17, 20, 24], "primari": 2, "sort": [2, 3, 9, 10, 24], "merg": [2, 7, 9, 16], "document": [2, 3, 5, 6, 7, 10, 12, 15, 23], "websit": 2, "streamprovid": 2, "trait": 2, "product": [2, 14, 23], "readi": 2, "shuffl": 2, "cleanup": 2, "fill": 2, "gap": 2, "task": [2, 3, 8], "exchang": 2, "better": [2, 3, 9], "error": [2, 3, 5, 9, 11, 15], "handl": [2, 3], "failur": 2, "executor": [2, 3], "lost": 2, "restart": 2, "monitor": 2, "log": 2, "auto": 2, "scale": [2, 3, 17], "multi": [2, 14, 15], "deploy": 2, "resili": 2, "fault": 2, "toler": 2, "ultim": 2, "shard": 2, "scalabl": 2, "cach": [2, 3], "group": [2, 3, 9, 10, 11, 19, 20], "base": [2, 5, 6, 9, 10, 12, 15, 18, 21, 23, 25], "alloc": [2, 15], "miss": 2, "sessioncontext": [2, 10, 11, 15], "editor": 2, "expos": [2, 9], "context": [2, 3, 5, 25], "hdf": 2, "timestamp": [2, 3, 17, 22, 24], "rang": 2, "predic": [2, 9, 24], "pushdown": [2, 24], "thread": [2, 13, 14, 15], "awar": [2, 11, 23], "sdk": 2, "experiment": [2, 17], "high": [3, 14], "It": [3, 5, 8, 12, 13, 15, 16, 18, 22, 23], "meant": 3, "restrict": 3, "rather": 3, "newcom": 3, "understand": 3, "head": 3, "inspir": 3, "part": [3, 10, 14], "model": [3, 5, 13, 14, 22], "entir": [3, 9], "volunt": 3, "befor": [3, 9, 10], "pr": [3, 7], "strongli": 3, "suggest": 3, "convers": [3, 5, 22], "mail": 3, "avoid": [3, 9], "surpris": 3, "embed": [3, 9], "choic": 3, "analyt": 3, "applic": [3, 9, 15], "leverag": [3, 9, 14], "uniqu": [3, 16], "provid": [3, 8, 9, 13, 14, 15, 18], "class": 3, "singl": [3, 5, 8, 9, 10, 13, 16, 25], "declar": [3, 5], "compat": [3, 8, 9, 24], "postgresql": [3, 6, 16], "similar": [3, 10, 22], "those": 3, "offer": [3, 5], "panda": [3, 10], "spark": [3, 6, 10, 16], "procedur": 3, "programmat": 3, "race": 3, "free": 3, "ergonom": 3, "extens": [3, 14], "point": [3, 14, 15], "layer": 3, "decim": [3, 9, 17], "122": 3, "complet": 3, "statu": [3, 20], "arithmet": 3, "194": 3, "parser": [3, 9, 24], "533": 3, "nest": [3, 24], "structur": 3, "struct": [3, 10, 12], "119": 3, "tpch": 3, "mileston": 3, "detail": [3, 8, 19], "sophist": 3, "order": [3, 8, 9, 15, 20, 24], "tokomak": 3, "440": 3, "finer": 3, "filesystem": 3, "s3": 3, "local": [3, 8], "907": 3, "1060": 3, "async": [3, 11, 15], "reader": [3, 5, 9], "chunk": 3, "prefetch": 3, "capabl": 3, "arrow2": 3, "h2oai": 3, "db": 3, "147": 3, "348": 3, "grain": 3, "control": [3, 9], "587": 3, "usag": [3, 7, 15, 16], "54": 3, "tbd": 3, "note": [3, 5, 8, 10, 12, 15, 17, 22], "thought": 3, "vision": 3, "1096": 3, "abstract": 3, "repl": 3, "pars": [3, 9], "separ": [3, 6], "correctli": 3, "connect": [3, 8, 14], "subsystem": 3, "print": [3, 8, 9, 10, 11, 15], "out": [3, 8, 9, 10], "stat": 3, "debug": 3, "interact": [3, 8], "shell": 3, "nuget": 3, "registri": [3, 10], "easili": 3, "adopt": 3, "shorter": 3, "like": [3, 8, 9], "dfcli": 3, "distribut": [3, 13], "comput": [3, 5, 13, 16], "break": 3, "stage": 3, "across": 3, "avail": [3, 8, 10, 12, 21], "cluster": 3, "remain": 3, "suitabl": [3, 16], "serial": [3, 9], "thei": [3, 5, 9], "agnost": 3, "than": [3, 8, 9, 12, 22], "advantag": 3, "over": [3, 9, 10], "becaus": [3, 5], "doesn": [3, 18], "t": [3, 11, 18, 21, 22, 23], "eagerli": 3, "direction": 3, "acycl": 3, "graph": 3, "dag": 3, "configur": [3, 7, 21], "concurr": [3, 9], "should": [3, 5, 6, 9, 23], "push": [3, 9, 24], "logic": [3, 9, 10, 12, 14, 19], "accur": [3, 16], "could": [3, 9], "hash": [3, 19], "desir": 3, "load": [3, 9], "side": [3, 9, 23], "cannot": [3, 9], "until": 3, "enumer": 5, "plane": 5, "enforc": 5, "assum": 5, "recordbatch": [5, 10], "arrai": [5, 12, 17, 24], "top": [5, 9], "dynam": 5, "object": 5, "as_ani": 5, "downcast": 5, "itself": [5, 14], "static": [5, 15], "int32arrai": 5, "data_typ": [5, 21], "respect": 5, "alwai": 5, "time": [5, 9, 12, 15, 16, 20, 22, 24], "onli": [5, 9, 10, 12, 22, 23, 25], "runtim": 5, "program": 5, "principl": 5, "user": [5, 6, 14, 15, 18], "know": 5, "datatyp": [5, 17], "nullabl": [5, 9, 10], "flag": [5, 9], "bool": 5, "whether": [5, 9], "valu": [5, 6, 8, 9, 16, 18, 22, 23, 24, 25], "null": [5, 8, 9, 12, 18, 22, 23], "pf": 5, "lf": 5, "root": [5, 8, 12, 22], "vector": [5, 10], "record": [5, 6, 9], "batch": [5, 6, 8, 9], "how": [5, 6, 7], "deriv": 5, "input": [5, 9, 10, 16], "logical_field": 5, "lf1": 5, "lf2": 5, "plu": [5, 6], "b": [5, 6, 8, 10, 11, 12, 19, 23], "none": [5, 17, 19, 22], "d": [5, 8], "get_supertyp": 5, "length": [5, 9, 12, 24], "u32": [5, 22], "tree": [5, 15], "compos": 5, "c1": [5, 6, 8, 10, 18], "c2": [5, 6, 8, 10, 18], "AS": [5, 8, 18, 22, 23], "sum12": 5, "scan": [5, 9, 18, 23], "u64": 5, "certain": 5, "frozen": 5, "while": [5, 9], "child": 5, "physical_field": 5, "pf1": 5, "pf2": 5, "whose": 5, "element": 5, "sum": [5, 12, 16, 19, 25], "two": [5, 9, 10], "togeth": [5, 12], "smallest": 5, "str": 5, "count": [5, 10, 12, 16, 23], "byte": [5, 9], "doe": [5, 9, 22], "sole": 5, "properti": 5, "index": [5, 9, 19], "associ": 5, "necessari": [5, 8, 18], "physicalplan": 5, "accept": [5, 12], "manner": 5, "hardwar": 5, "environ": [5, 7, 8, 9], "extra": 5, "paramet": [5, 22], "logical_plan": [5, 19], "param": 5, "subsect": 5, "min": [5, 9, 10, 11, 12, 16], "tableprovid": [5, 9, 15], "likewis": 5, "specif": [5, 6, 7, 14, 21], "my_op": 5, "thu": [5, 17], "word": 5, "understood": 5, "must": [5, 6, 9, 10, 11, 22], "guarante": 5, "select": [5, 6, 9, 10, 11, 12, 15, 17, 18, 19, 20, 21, 22, 25], "t1": [5, 6], "id": [5, 6, 10], "t2": [5, 6], "unambigu": 5, "violat": 5, "content": 5, "correspond": [5, 8, 17], "particularli": 5, "intermediari": 5, "calcul": [5, 10], "i32": 5, "i64": 5, "computation": 5, "expens": 5, "panic": 5, "satisfi": 5, "match": [5, 10, 23, 25], "claim": 5, "int32": [5, 17], "safe": 5, "parquet": [5, 9, 10, 14, 18, 24], "branch": 5, "combin": 5, "equival": [5, 12, 22], "physical_schema": 5, "qualifi": [5, 6], "strip": 5, "strip_rel": 5, "f": [5, 6, 8], "reli": 5, "simpl": [5, 11], "corollari": 5, "triplet": 5, "rule": [5, 9], "physical_plan": [5, 19], "consum": [5, 9], "downscal": 5, "jeopard": 5, "referenc": [5, 23], "assumpt": 5, "about": [5, 21], "bare": 6, "contain": [6, 8, 9], "tabl": [6, 8, 9, 11, 15, 17, 19, 20, 21, 23, 24, 25], "df": [6, 10, 11, 15], "select_column": [6, 10], "compound": 6, "foo": [6, 12], "bar": 6, "convert": [6, 8, 9, 22], "lowercas": [6, 9], "avg": [6, 12, 16], "wrap": 6, "quot": [6, 8, 9, 11, 23], "doubl": [6, 8, 11, 17, 18, 23], "parenthes": 6, "operand": 6, "space": [6, 22], "1": [6, 8, 9, 11, 12, 15, 16, 17, 18, 19, 21, 22, 23, 25], "comma": 6, "vec": [6, 10, 11], "udf": [6, 10, 15, 24], "col": [6, 10, 11, 12], "schema": [6, 8, 9, 10, 17, 18, 20, 23, 24], "test": [6, 7, 8, 10, 11, 14, 15, 18], "sampl": 6, "int": [6, 8, 17, 18], "varchar": [6, 8, 17, 18], "5": [6, 16, 18], "insert": [6, 9], "INTO": 6, "hello": [6, 12, 18], "world": 6, "ON": [6, 23], "mysql": 6, "8": [6, 8, 9, 22], "13": 6, "sqlite": 6, "ab": [6, 10, 12], "foo_bar": 6, "7": [6, 12], "introduct": 7, "capit": [7, 23], "util": 7, "frequent": 7, "question": 7, "crate": [7, 15], "pull": 7, "request": 7, "window": [7, 9, 24], "setup": 7, "protoc": 7, "instal": [7, 15], "bootstrap": 7, "organ": 7, "scalar": [7, 20], "displai": [7, 9, 12, 22], "graphic": 7, "md": 7, "roadmap": 7, "ballista": 7, "quarterli": 7, "2022": [7, 18], "q2": 7, "tracker": 7, "conveni": [8, 14], "own": [8, 15], "echo": 8, "compress": 8, "avro": [8, 24], "json": [8, 10, 24], "v17": 8, "took": 8, "007": 8, "second": [8, 22], "l": 8, "data_dir": 8, "data2": 8, "v16": 8, "easiest": 8, "spin": 8, "via": [8, 9], "pre": [8, 16], "ghcr": 8, "v2": 8, "manifest": 8, "100": [8, 10, 11, 16], "blob": [8, 17], "sha256": [8, 12], "9ecc8a01be47ceb9a53b39976696afa87c0a8": 8, "pkg": 8, "githubusercont": 8, "com": 8, "ghcr1": 8, "9ecc8a01be47ceb9a53b39976": 8, "pour": 8, "big_sur": 8, "bottl": 8, "tar": 8, "gz": 8, "usr": 8, "cellar": 8, "9": [8, 22], "17": 8, "4mb": 8, "imag": 8, "clone": 8, "dockerignor": 8, "delet": 8, "checkout": 8, "cd": [8, 15], "dockerfil": 8, "v": 8, "your_data_loc": 8, "client": 8, "size": [8, 9], "batch_siz": [8, 9, 21], "default": [8, 9, 12, 16, 22, 23], "tsv": 8, "nd": 8, "h": 8, "data_path": 8, "q": 8, "quiet": 8, "reduc": [8, 9], "quietli": 8, "rc": 8, "startup": 8, "datafusionrc": 8, "enclos": 8, "shown": 8, "back": 8, "explicitli": 8, "extern": [8, 17, 20], "statement": [8, 9, 10, 18, 19, 22], "taxi": [8, 18], "locat": [8, 9, 18], "mnt": [8, 18], "nyctaxi": [8, 18], "tripdata": [8, 18], "WITH": [8, 18, 20], "header": [8, 9, 18], "aggregate_test_100": [8, 18], "NOT": [8, 18, 20], "c3": [8, 18], "smallint": [8, 17, 18], "c4": [8, 18], "c5": [8, 18], "c6": [8, 18], "bigint": [8, 17, 18], "c7": [8, 18], "c8": [8, 18], "c9": [8, 18], "c10": [8, 18], "c11": [8, 18], "float": [8, 9, 17, 18], "c12": [8, 18], "c13": [8, 18], "aws_default_region": 8, "aws_access_key_id": 8, "aws_secret_access_kei": 8, "access_key_id": 8, "secret_access_kei": 8, "region": 8, "aws_endpoint": 8, "endpoint": 8, "aws_session_token": 8, "token": 8, "aws_container_credentials_relative_uri": 8, "aw": 8, "amazon": 8, "amazonec": 8, "developerguid": 8, "iam": 8, "role": 8, "html": 8, "aws_allow_http": 8, "true": [8, 9, 15, 21], "permit": 8, "tl": 8, "cp": 8, "my": 8, "bucket": 8, "upload": 8, "export": 8, "east": 8, "v14": 8, "374": 8, "column_1": [8, 23, 25], "column_2": [8, 23, 25], "171": 8, "insid": 8, "quit": 8, "listtabl": 8, "describet": 8, "table_nam": [8, 18, 21], "quietmod": 8, "fals": [8, 9, 19, 21], "search": 8, "show": [8, 10, 11, 15, 19, 21, 23, 24], "8192": [8, 9, 21], "coalesce_batch": [8, 9, 21], "coalesce_target_batch_s": [8, 21], "4096": [8, 19, 21], "time_zon": [8, 9, 21], "explain": [8, 9, 10, 20, 21], "logical_plan_onli": [8, 9, 21], "physical_plan_onli": [8, 9, 21], "optim": [8, 9, 10, 14, 21, 24], "filter_null_join_kei": [8, 9, 21], "skip_failed_rul": [8, 9, 21], "1024": 8, "seen": 8, "abov": 8, "look": 8, "upper": [8, 12], "_": 8, "would": [8, 9], "datafusion_execution_batch_s": [8, 9], "v12": 8, "002": 8, "v13": 8, "011": 8, "000": 8, "005": 8, "sessionconfig": 9, "variou": 9, "aspect": 9, "construct": 9, "session": [9, 21], "from_env": 9, "kei": [9, 10], "transform": 9, "uppercas": 9, "period": 9, "replac": [9, 12, 18, 24], "underscor": 9, "accord": [9, 17], "cast": [9, 17, 22, 24], "utf8": [9, 17], "warn": 9, "emit": 9, "initialis": 9, "beforehand": 9, "affect": 9, "descript": 9, "catalog": [9, 18, 21], "create_default_catalog_and_schema": 9, "default_catalog": 9, "impact": 9, "specifi": [9, 10, 18, 19, 22], "default_schema": 9, "information_schema": [9, 21, 24], "virtual": [9, 18], "has_head": [9, 19], "especi": 9, "buffer": 9, "tini": 9, "too": 9, "much": 9, "consumpt": 9, "examin": 9, "coalesc": [9, 12, 24], "larger": 9, "filter": [9, 10, 11, 12, 24, 25], "produc": [9, 23, 25], "target": [9, 15], "collect_statist": 9, "collect": [9, 10], "target_partit": 9, "increas": [9, 15], "zone": 9, "extract": [9, 24], "some_tim": 9, "shift": [9, 12], "underli": [9, 22], "enable_page_index": 9, "decod": 9, "prune": [9, 18], "attempt": 9, "skip": 9, "max": [9, 12, 16, 23], "skip_metadata": 9, "conflict": 9, "metadata_size_hint": 9, "fetch": 9, "last": 9, "size_hint": 9, "optimist": 9, "footer": 9, "anoth": [9, 10], "encod": 9, "pushdown_filt": 9, "reorder_filt": 9, "reorder": [9, 24], "heurist": 9, "minim": [9, 10], "cost": [9, 16], "enable_round_robin_repartit": 9, "round": [9, 12], "robin": 9, "repartit": [9, 10], "column": [9, 10, 11, 12, 16, 19, 21, 22, 23, 24], "overhead": 9, "fulli": 9, "repartition_aggreg": 9, "repartition_file_min_s": 9, "10485760": 9, "minimum": 9, "total": [9, 10], "repartition_join": 9, "repartition_file_scan": 9, "achiev": 9, "maximum": [9, 23], "though": 9, "repartition_window": 9, "repartition_sort": 9, "per": [9, 10], "fashion": 9, "afterward": 9, "With": 9, "enabl": 9, "form": 9, "sortexec": 9, "asc": [9, 23], "coalescepartitionsexec": [9, 19], "repartitionexec": [9, 19], "roundrobinbatch": [9, 19], "input_partit": 9, "turn": [9, 10], "multithread": 9, "sortpreservingmergeexec": 9, "proce": 9, "next": 9, "caus": 9, "max_pass": 9, "top_down_join_key_reord": 9, "prefer_hash_join": 9, "prefer": 9, "hashjoin": 9, "sortmergejoin": 9, "hash_join_single_partition_threshold": 9, "1048576": 9, "estim": 9, "sql_parser": 9, "parse_float_as_decim": 9, "enable_ident_norm": 9, "normal": 9, "ident": 9, "typic": 10, "read_csv": [10, 11], "modifi": 10, "definit": 10, "prelud": [10, 11, 15], "ctx": [10, 11, 15], "csv": [10, 14, 18, 19, 24], "csvreadopt": [10, 11, 15], "await": [10, 11, 15], "lt_eq": [10, 11, 12], "lazi": 10, "just": 10, "approach": 10, "allow": [10, 12, 14, 23], "overal": 10, "invok": 10, "distinct": [10, 16, 23], "duplic": 10, "except": [10, 22, 24], "exactli": 10, "intersect": [10, 24], "join_on": 10, "arbitrari": 10, "scheme": 10, "union": [10, 20, 24], "union_distinct": 10, "with_column": 10, "with_column_renam": 10, "renam": 10, "stdout": 10, "disk": 10, "collect_partit": 10, "execute_stream": 10, "stream": [10, 16], "execute_stream_partit": 10, "show_limit": 10, "subset": [10, 18], "write_csv": 10, "write_json": 10, "write_parquet": 10, "explan": 10, "far": 10, "functionregistri": 10, "term": 10, "attribut": 10, "to_logical_plan": 10, "to_unoptimized_plan": 10, "unoptim": 10, "11": [11, 15, 18], "tokio": [11, 15], "main": 11, "fn": [11, 15], "register_csv": [11, 15], "BY": [11, 18, 19, 20, 24], "ok": [11, 15], "effect": [11, 23], "lower": [11, 12, 23], "letter": 11, "won": 11, "illustr": 11, "capitalized_exampl": 11, "method": 12, "chain": 12, "fluent": 12, "style": [12, 18], "6": [12, 18], "AND": 12, "gt": 12, "lit": 12, "lt": 12, "123": [12, 22], "expr1": 12, "expr2": 12, "eq": 12, "gt_eq": 12, "not_eq": 12, "x": [12, 16, 19, 23, 25], "absolut": [12, 22], "aco": 12, "invers": [12, 22], "cosin": [12, 22], "asin": 12, "sine": [12, 22], "atan": 12, "tangent": [12, 22], "atan2": 12, "ceil": 12, "nearest": [12, 22], "integ": [12, 17, 22, 23], "equal": [12, 16, 22], "co": 12, "exp": 12, "exponenti": [12, 22], "floor": 12, "less": [12, 22], "ln": 12, "natur": [12, 22], "logarithm": [12, 22], "log10": 12, "10": [12, 22, 23], "log2": 12, "power": 12, "expon": 12, "rais": [12, 22], "signum": 12, "sign": [12, 22], "sin": 12, "sqrt": 12, "squar": [12, 22], "tan": 12, "trunc": 12, "truncat": [12, 22], "toward": [12, 22], "zero": [12, 22, 25], "OR": [12, 18], "xor": 12, "left": [12, 24], "right": [12, 24], "often": [12, 22], "substitut": [12, 22], "retriev": [12, 22], "otherwis": [12, 22], "end": [12, 15], "nullif": [12, 24], "value1": [12, 22], "value2": [12, 22], "ascii": [12, 24], "bit_length": [12, 24], "btrim": [12, 24], "char_length": [12, 24], "character_length": [12, 24], "concat": [12, 24], "concat_w": [12, 24], "chr": [12, 24], "initcap": [12, 24], "lpad": [12, 24], "ltrim": [12, 24], "md5": 12, "octet_length": [12, 24], "repeat": [12, 24], "revers": [12, 24], "rpad": [12, 24], "rtrim": [12, 24], "digest": 12, "split_part": [12, 24], "starts_with": [12, 24], "strpo": [12, 24], "substr": [12, 24], "translat": [12, 24], "trim": [12, 24], "regexp_match": 12, "regexp_replac": [12, 24], "date_part": [12, 24], "date_trunc": 12, "from_unixtim": 12, "to_timestamp": [12, 24], "to_timestamp_milli": [12, 24], "to_timestamp_micro": [12, 24], "to_timestamp_second": [12, 24], "now": 12, "in_list": 12, "random": 12, "sha224": 12, "sha384": 12, "sha512": 12, "to_hex": [12, 24], "approx_distinct": [12, 24], "approx_median": [12, 24], "approx_percentile_cont": [12, 24], "approx_percentile_cont_with_weight": [12, 24], "count_distinct": 12, "cube": 12, "grouping_set": 12, "median": [12, 16], "rollup": 12, "in_subqueri": 12, "df1": 12, "df2": 12, "IN": [12, 20], "not_exist": 12, "not_in_subqueri": 12, "scalar_subqueri": 12, "create_udf": 12, "create_udaf": 12, "represent": 13, "columnar": 13, "kernel": 13, "common": [13, 24], "extrem": 14, "modern": 14, "pipelin": 14, "etl": 14, "databas": 14, "easi": 14, "Being": 14, "ecosystem": 14, "flight": 14, "rest": 14, "big": 14, "emb": 14, "almost": 14, "tailor": 14, "usecas": 14, "qualiti": 14, "hello_datafus": 15, "toml": 15, "path_to_your_csv_fil": 15, "udaf": [15, 24], "rewrit": 15, "executionplan": 15, "step": 15, "worth": 15, "profil": 15, "significantli": 15, "simd": 15, "rt": 15, "snmalloc": 15, "lto": 15, "codegen": 15, "unit": 15, "global_alloc": 15, "snmalloc_r": 15, "final": 15, "nightli": 15, "toolchain": 15, "architectur": 15, "ideal": 15, "nativ": 15, "avx2": 15, "rustflag": 15, "array_agg": 16, "var": 16, "var_samp": 16, "var_pop": 16, "stddev": 16, "stddev_samp": 16, "stddev_pop": 16, "covar": 16, "covar_samp": 16, "covar_pop": 16, "corr": 16, "uint64": [16, 17], "hyperloglog": 16, "alia": 16, "percentil": 16, "tdigest": 16, "float64": [16, 17, 22], "inclus": 16, "raw": 16, "sketch": 16, "n": 16, "centroid": 16, "fewer": 16, "exact": 16, "higher": 16, "weight": 16, "stand": 16, "low": 16, "latenc": 16, "olap": 16, "flink": 16, "sqlparser": 17, "arrow_typeof": 17, "interv": 17, "month": [17, 18, 22], "arrowtypeof": [17, 22], "intervalyearmonth": 17, "yearmonth": 17, "char": 17, "text": 17, "tinyint": 17, "int8": 17, "int16": 17, "int64": [17, 21, 22], "unsign": 17, "uint8": 17, "uint16": 17, "uint32": 17, "float32": 17, "real": 17, "precis": 17, "decimal128": 17, "3523": 17, "date32": [17, 22], "time64": 17, "timeunit": 17, "nanosecond": [17, 22], "intervalunit": 17, "daytim": 17, "bytea": 17, "uuid": 17, "Not": 17, "yet": 17, "clob": 17, "varbinari": 17, "regclass": 17, "nvarchar": 17, "enum": 17, "infer": [18, 23], "aggregate_simpl": 18, "manual": 18, "alreadi": 18, "hive": 18, "year": [18, 22], "01": [18, 22], "IF": 18, "valuet": 18, "memtabl": 18, "silent": 18, "ignor": 18, "nonexistent_t": 18, "view_nam": 18, "column1": 18, "column2": 18, "users_v": 18, "customer_a": 18, "verbos": 19, "plan_typ": 19, "groupbi": 19, "aggr": 19, "tablescan": 19, "projectionexec": 19, "aggregateexec": 19, "mode": 19, "finalpartit": 19, "gby": 19, "coalescebatchesexec": 19, "target_batch_s": 19, "partial": 19, "csvexec": 19, "metric": 19, "hashaggregateexec": 19, "outputrow": 19, "sendtim": 19, "839560": 19, "fetchtim": 19, "122528525": 19, "repartitiontim": 19, "5327877": 19, "5660489": 19, "8012": 19, "charact": 20, "numer": 20, "date": [20, 22, 24], "boolean": 20, "unsupport": 20, "syntax": [20, 25], "claus": [20, 24], "subqueri": [20, 24], "ddl": 20, "drop": 20, "view": [20, 21, 24], "analyz": 20, "approxim": [20, 24], "condit": [20, 23, 24], "regular": 20, "tempor": 20, "iso": 21, "table_catalog": 21, "table_schema": 21, "table_typ": 21, "column_nam": 21, "is_nul": 21, "NO": 21, "df_set": 21, "1997": 22, "31t09": 22, "26": 22, "56": 22, "123z": 22, "rcf3339": 22, "05": 22, "31": 22, "09": 22, "close": 22, "er": 22, "et": 22, "offset": 22, "fraction": 22, "epoch": 22, "present": 22, "consist": 22, "to_timestamp_xx": 22, "millisecond": 22, "resolut": 22, "microsecond": 22, "secondsecond": 22, "subfield": 22, "date64": 22, "2020": 22, "08t12": 22, "week": 22, "37": 22, "dai": 22, "minut": 22, "03": 22, "postgr": [22, 24], "wherev": 22, "appear": 22, "chosen": 22, "accordingli": 23, "clarif": 23, "with_queri": 23, "select_expr": 23, "from_item": 23, "join_item": 23, "grouping_el": 23, "desc": 23, "quantifi": 23, "By": 23, "person": 23, "ag": 23, "employe": 23, "keyword": 23, "even": 23, "cartesian": 23, "table1": 23, "table2": 23, "ascend": 23, "descend": 23, "neg": 23, "planner": 24, "constant": 24, "fold": 24, "coercion": 24, "post": 24, "try_cast": 24, "basic": 24, "inner": 24, "cross": 24, "empti": 24, "frame": 24, "primit": 24, "correl": 25}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"commun": 0, "question": [0, 13], "mail": 0, "list": 0, "slack": 0, "discord": 0, "sync": 0, "up": 0, "video": 0, "call": 0, "introduct": [1, 14], "pull": 1, "request": 1, "merg": 1, "pr": 1, "develop": 1, "": 1, "guid": [1, 7], "window": 1, "setup": 1, "protoc": 1, "instal": [1, 8], "bootstrap": 1, "environ": 1, "test": 1, "organ": 1, "unit": 1, "rust": [1, 15], "integr": 1, "sqllogictest": 1, "benchmark": 1, "criterion": 1, "parquet": [1, 8], "sql": [1, 3, 8, 11, 20, 24], "upstream": 1, "suit": 1, "how": 1, "add": 1, "new": [1, 15], "scalar": [1, 22, 25], "function": [1, 5, 6, 12, 15, 16, 22], "aggreg": [1, 12, 16], "displai": 1, "plan": [1, 5], "graphic": 1, "specif": [1, 4], "format": 1, "md": 1, "document": 1, "quarterli": 2, "roadmap": [2, 3], "2022": 2, "q2": 2, "datafus": [2, 3, 7, 8, 13, 14, 15], "core": 2, "ballista": [2, 3, 13], "extens": [2, 15], "contrib": 2, "python": [2, 3], "s3": [2, 8], "tui": 2, "bigtabl": 2, "stream": 2, "addit": 3, "languag": 3, "featur": 3, "queri": [3, 8, 11], "optim": [3, 5, 15], "datasourc": 3, "runtim": 3, "infrastructur": 3, "resourc": 3, "manag": 3, "interfac": 3, "cli": 3, "move": 3, "schedul": 3, "implement": 3, "execut": 3, "time": [3, 17], "cost": 3, "base": [3, 22], "statist": [3, 16], "invari": 5, "ration": 5, "notat": 5, "logic": 5, "column": [5, 6], "physic": 5, "data": [5, 8, 11, 17, 24], "sourc": [5, 8, 24], "registri": 5, "planner": 5, "builder": 5, "relat": 5, "name": [5, 6], "tupl": 5, "field": [5, 6], "ar": 5, "uniqu": 5, "respons": 5, "valid": 5, "schema": [5, 21], "i": [5, 13], "consist": 5, "The": 5, "under": 5, "output": [5, 6, 11], "equal": 5, "semant": 6, "rule": 6, "appendic": 6, "exampl": [6, 8, 11], "comparison": [6, 12], "other": [6, 10, 12, 22], "system": 6, "project": [6, 15], "transform": [6, 10], "oper": [6, 12], "liter": [6, 12], "apach": [7, 13], "arrow": [7, 13], "tabl": [7, 18], "content": 7, "user": [7, 12], "contributor": 7, "command": 8, "line": 8, "util": 8, "run": [8, 11], "us": [8, 11, 14, 15], "cargo": [8, 11], "homebrew": 8, "maco": 8, "docker": 8, "usag": [8, 11], "select": [8, 23], "file": 8, "directli": 8, "regist": 8, "csv": [8, 11], "chang": 8, "configur": [8, 9, 15], "option": 8, "set": 9, "datafram": [10, 11], "api": [10, 11], "action": 10, "method": 10, "updat": 11, "toml": 11, "against": 11, "store": 11, "process": 11, "from": [11, 23], "both": 11, "identifi": [11, 12], "capit": 11, "express": [12, 22], "valu": 12, "boolean": [12, 17], "math": [12, 22], "bitwis": 12, "condit": [12, 22], "string": [12, 22], "regular": [12, 22], "tempor": [12, 22], "subqueri": [12, 25], "defin": 12, "frequent": 13, "ask": 13, "what": 13, "relationship": 13, "between": 13, "case": 14, "why": 14, "librari": 15, "creat": [15, 18], "default": 15, "main": 15, "version": 15, "compat": 15, "gener": [16, 24], "approxim": 16, "approx_distinct": 16, "approx_median": 16, "approx_percentile_cont": 16, "approx_percentile_cont_with_weight": 16, "type": 17, "charact": 17, "numer": 17, "date": 17, "binari": 17, "unsupport": 17, "ddl": 18, "extern": 18, "drop": 18, "view": 18, "explain": 19, "analyz": 19, "refer": 20, "inform": 21, "ab": 22, "x": 22, "aco": 22, "asin": 22, "atan": 22, "atan2": 22, "y": 22, "ceil": 22, "co": 22, "exp": 22, "floor": 22, "ln": 22, "log10": 22, "log2": 22, "power": 22, "expon": 22, "round": 22, "signum": 22, "sin": 22, "sqrt": 22, "tan": 22, "trunc": 22, "coalesc": 22, "nullif": 22, "ascii": 22, "bit_length": 22, "btrim": 22, "char_length": 22, "character_length": 22, "concat": 22, "concat_w": 22, "chr": 22, "initcap": 22, "left": [22, 23], "length": 22, "lower": 22, "lpad": 22, "ltrim": 22, "md5": 22, "octet_length": 22, "repeat": 22, "replac": 22, "revers": 22, "right": [22, 23], "rpad": 22, "rtrim": 22, "digest": 22, "split_part": 22, "starts_with": 22, "strpo": 22, "substr": 22, "translat": 22, "trim": 22, "upper": 22, "regexp_match": 22, "regexp_replac": 22, "to_timestamp": 22, "to_timestamp_milli": 22, "to_timestamp_micro": 22, "to_timestamp_second": 22, "extract": 22, "date_part": 22, "date_trunc": 22, "date_bin": 22, "from_unixtim": 22, "now": 22, "arrai": 22, "arrow_typeof": 22, "in_list": 22, "random": 22, "sha224": 22, "sha256": 22, "sha384": 22, "sha512": 22, "struct": 22, "to_hex": 22, "syntax": 23, "WITH": 23, "claus": 23, "where": 23, "join": 23, "inner": 23, "outer": 23, "full": 23, "cross": 23, "group": 23, "BY": 23, "have": 23, "union": 23, "order": 23, "limit": 23, "statu": 24, "support": 24, "exist": 25, "NOT": 25, "IN": 25}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 6, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx": 56}}) \ No newline at end of file diff --git a/datafusion/user-guide/cli.html b/datafusion/user-guide/cli.html deleted file mode 100644 index d30c06e18c3b..000000000000 --- a/datafusion/user-guide/cli.html +++ /dev/null @@ -1,733 +0,0 @@ - - - - - - - - - DataFusion Command-line SQL Utility — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

DataFusion Command-line SQL Utility

-

The DataFusion CLI is a command-line interactive SQL utility for executing -queries against any supported data files. It is a convenient way to -try DataFusion out with your own data sources, and test out its SQL support.

-
-

Example

-

Create a CSV file to query.

-
$ echo "a,b" > data.csv
-$ echo "1,2" >> data.csv
-
-
-

Query that single file (the CLI also supports parquet, compressed csv, avro, json and more)

-
$ datafusion-cli
-DataFusion CLI v17.0.0
-❯ select * from 'data.csv';
-+---+---+
-| a | b |
-+---+---+
-| 1 | 2 |
-+---+---+
-1 row in set. Query took 0.007 seconds.
-
-
-

You can also query directories of files with compatible schemas:

-
$ ls data_dir/
-data.csv   data2.csv
-
-
-
$ datafusion-cli
-DataFusion CLI v16.0.0
-❯ select * from 'data_dir';
-+---+---+
-| a | b |
-+---+---+
-| 3 | 4 |
-| 1 | 2 |
-+---+---+
-2 rows in set. Query took 0.007 seconds.
-
-
-
-
-

Installation

-
-

Install and run using Cargo

-

The easiest way to install DataFusion CLI a spin is via cargo install datafusion-cli.

-
-
-

Install and run using Homebrew (on MacOS)

-

DataFusion CLI can also be installed via Homebrew (on MacOS). Install it as any other pre-built software like this:

-
brew install datafusion
-# ==> Downloading https://ghcr.io/v2/homebrew/core/datafusion/manifests/12.0.0
-# ######################################################################## 100.0%
-# ==> Downloading https://ghcr.io/v2/homebrew/core/datafusion/blobs/sha256:9ecc8a01be47ceb9a53b39976696afa87c0a8
-# ==> Downloading from https://pkg-containers.githubusercontent.com/ghcr1/blobs/sha256:9ecc8a01be47ceb9a53b39976
-# ######################################################################## 100.0%
-# ==> Pouring datafusion--12.0.0.big_sur.bottle.tar.gz
-# 🍺  /usr/local/Cellar/datafusion/12.0.0: 9 files, 17.4MB
-
-datafusion-cli
-
-
-
-
-

Run using Docker

-

There is no officially published Docker image for the DataFusion CLI, so it is necessary to build from source -instead.

-

Use the following commands to clone this repository and build a Docker image containing the CLI tool. Note -that there is .dockerignore file in the root of the repository that may need to be deleted in order for -this to work.

-
git clone https://github.com/apache/arrow-datafusion
-git checkout 12.0.0
-cd arrow-datafusion
-docker build -f datafusion-cli/Dockerfile . --tag datafusion-cli
-docker run -it -v $(your_data_location):/data datafusion-cli
-
-
-
-
-
-

Usage

-

See the current usage using datafusion-cli --help:

-
Apache Arrow <dev@arrow.apache.org>
-Command Line Client for DataFusion query engine.
-
-USAGE:
-    datafusion-cli [OPTIONS]
-
-OPTIONS:
-    -c, --batch-size <BATCH_SIZE>    The batch size of each query, or use DataFusion default
-    -f, --file <FILE>...             Execute commands from file(s), then exit
-        --format <FORMAT>            [default: table] [possible values: csv, tsv, table, json,
-                                     nd-json]
-    -h, --help                       Print help information
-    -p, --data-path <DATA_PATH>      Path to your data, default to current directory
-    -q, --quiet                      Reduce printing other than the results and work quietly
-    -r, --rc <RC>...                 Run the provided files on startup instead of ~/.datafusionrc
-    -V, --version                    Print version information
-
-
-
-
-

Selecting files directly

-

Files can be queried directly by enclosing the file or -directory name in single ' quotes as shown in the example.

-

It is also possible to create a table backed by files by explicitly -via CREATE EXTERNAL TABLE as shown below.

-
-
-

Registering Parquet Data Sources

-

Parquet data sources can be registered by executing a CREATE EXTERNAL TABLE SQL statement. It is not necessary to provide schema information for Parquet files.

-
CREATE EXTERNAL TABLE taxi
-STORED AS PARQUET
-LOCATION '/mnt/nyctaxi/tripdata.parquet';
-
-
-
-
-

Registering CSV Data Sources

-

CSV data sources can be registered by executing a CREATE EXTERNAL TABLE SQL statement.

-
CREATE EXTERNAL TABLE test
-STORED AS CSV
-WITH HEADER ROW
-LOCATION '/path/to/aggregate_test_100.csv';
-
-
-

It is also possible to provide schema information.

-
CREATE EXTERNAL TABLE test (
-    c1  VARCHAR NOT NULL,
-    c2  INT NOT NULL,
-    c3  SMALLINT NOT NULL,
-    c4  SMALLINT NOT NULL,
-    c5  INT NOT NULL,
-    c6  BIGINT NOT NULL,
-    c7  SMALLINT NOT NULL,
-    c8  INT NOT NULL,
-    c9  BIGINT NOT NULL,
-    c10 VARCHAR NOT NULL,
-    c11 FLOAT NOT NULL,
-    c12 DOUBLE NOT NULL,
-    c13 VARCHAR NOT NULL
-)
-STORED AS CSV
-LOCATION '/path/to/aggregate_test_100.csv';
-
-
-
-
-

Querying S3 Data Sources

-

The CLI can query data in S3 if the following environment variables are defined:

-
    -

  • AWS_DEFAULT_REGION

    • -

  • AWS_ACCESS_KEY_ID

    • -

  • AWS_SECRET_ACCESS_KEY

    • -
-

Details of the environment variables that can be used are

- -

Example:

-
$ aws s3 cp test.csv s3://my-bucket/
-upload: ./test.csv to s3://my-bucket/test.csv
-
-$ export AWS_DEFAULT_REGION=us-east-2
-$ export AWS_SECRET_ACCESS_KEY=***************************
-$ export AWS_ACCESS_KEY_ID=**************
-
-$ datafusion-cli
-DataFusion CLI v14.0.0
-❯ create external table test stored as csv location 's3://my-bucket/test.csv';
-0 rows in set. Query took 0.374 seconds.
-❯ select * from test;
-+----------+----------+
-| column_1 | column_2 |
-+----------+----------+
-| 1        | 2        |
-+----------+----------+
-1 row in set. Query took 0.171 seconds.
-
-
-
-
-

Commands

-

Available commands inside DataFusion CLI are:

-
    -

  • Quit

    • -
-
> \q
-
-
-
    -

  • Help

    • -
-
> \?
-
-
-
    -

  • ListTables

    • -
-
> \d
-
-
-
    -

  • DescribeTable

    • -
-
> \d table_name
-
-
-
    -

  • QuietMode

    • -
-
> \quiet [true|false]
-
-
-
    -

  • list function

    • -
-
> \h
-
-
-
    -

  • Search and describe function

    • -
-
> \h function
-
-
-
    -

  • Show configuration options

    • -
-
> show all;
-
-+-------------------------------------------------+---------+
-| name                                            | setting |
-+-------------------------------------------------+---------+
-| datafusion.execution.batch_size                 | 8192    |
-| datafusion.execution.coalesce_batches           | true    |
-| datafusion.execution.coalesce_target_batch_size | 4096    |
-| datafusion.execution.time_zone                  | UTC     |
-| datafusion.explain.logical_plan_only            | false   |
-| datafusion.explain.physical_plan_only           | false   |
-| datafusion.optimizer.filter_null_join_keys      | false   |
-| datafusion.optimizer.skip_failed_rules          | true    |
-+-------------------------------------------------+---------+
-
-
-
    -

  • Set configuration options

    • -
-
> SET datafusion.execution.batch_size to 1024;
-
-
-
-
-

Changing Configuration Options

-

All available configuration options can be seen using SHOW ALL as described above.

-

You can change the configuration options using environment -variables. datafusion-cli looks in the corresponding environment -variable with an upper case name and all . converted to _.

-

For example, to set datafusion.execution.batch_size to 1024 you -would set the DATAFUSION_EXECUTION_BATCH_SIZE environment variable -appropriately:

-
$ DATAFUSION_EXECUTION_BATCH_SIZE=1024 datafusion-cli
-DataFusion CLI v12.0.0
-❯ show all;
-+-------------------------------------------------+---------+
-| name                                            | setting |
-+-------------------------------------------------+---------+
-| datafusion.execution.batch_size                 | 1024    |
-| datafusion.execution.coalesce_batches           | true    |
-| datafusion.execution.coalesce_target_batch_size | 4096    |
-| datafusion.execution.time_zone                  | UTC     |
-| datafusion.explain.logical_plan_only            | false   |
-| datafusion.explain.physical_plan_only           | false   |
-| datafusion.optimizer.filter_null_join_keys      | false   |
-| datafusion.optimizer.skip_failed_rules          | true    |
-+-------------------------------------------------+---------+
-8 rows in set. Query took 0.002 seconds.
-
-
-

You can change the configuration options using SET statement as well

-
$ datafusion-cli
-DataFusion CLI v13.0.0
-
-❯ show datafusion.execution.batch_size;
-+---------------------------------+---------+
-| name                            | setting |
-+---------------------------------+---------+
-| datafusion.execution.batch_size | 8192    |
-+---------------------------------+---------+
-1 row in set. Query took 0.011 seconds.
-
-❯ set datafusion.execution.batch_size to 1024;
-0 rows in set. Query took 0.000 seconds.
-
-❯ show datafusion.execution.batch_size;
-+---------------------------------+---------+
-| name                            | setting |
-+---------------------------------+---------+
-| datafusion.execution.batch_size | 1024    |
-+---------------------------------+---------+
-1 row in set. Query took 0.005 seconds.
-
-
-
-
- - -
- - - -
- - -
-

previous

-

Using DataFusion as a library

-
- - -
-

next

-

DataFrame API

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/configs.html b/datafusion/user-guide/configs.html deleted file mode 100644 index dad50b571215..000000000000 --- a/datafusion/user-guide/configs.html +++ /dev/null @@ -1,520 +0,0 @@ - - - - - - - - - Configuration Settings — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- - - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - - -
-

Configuration Settings

-

The following configuration options can be passed to SessionConfig to control various aspects of query execution.

-

For applications which do not expose SessionConfig, like datafusion-cli, these options may also be set via environment variables. -To construct a session with options from the environment, use SessionConfig::from_env. -The name of the environment variable is the option’s key, transformed to uppercase and with periods replaced with underscores. -For example, to configure datafusion.execution.batch_size you would set the DATAFUSION_EXECUTION_BATCH_SIZE environment variable. -Values are parsed according to the same rules used in casts from Utf8. -If the value in the environment variable cannot be cast to the type of the configuration option, the default value will be used instead and a warning emitted. -Environment variables are read during SessionConfig initialisation so they must be set beforehand and will not affect running sessions.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

key

default

description

datafusion.catalog.create_default_catalog_and_schema

true

Whether the default catalog and schema should be created automatically.

datafusion.catalog.default_catalog

datafusion

The default catalog name - this impacts what SQL queries use if not specified

datafusion.catalog.default_schema

public

The default schema name - this impacts what SQL queries use if not specified

datafusion.catalog.information_schema

false

Should DataFusion provide access to information_schema virtual tables for displaying schema information

datafusion.catalog.location

NULL

Location scanned to load tables for default schema

datafusion.catalog.format

NULL

Type of TableProvider to use when loading default schema

datafusion.catalog.has_header

false

If the file has a header

datafusion.execution.batch_size

8192

Default batch size while creating new batches, it’s especially useful for buffer-in-memory batches since creating tiny batches would results in too much metadata memory consumption

datafusion.execution.coalesce_batches

true

When set to true, record batches will be examined between each operator and small batches will be coalesced into larger batches. This is helpful when there are highly selective filters or joins that could produce tiny output batches. The target batch size is determined by the configuration setting

datafusion.execution.collect_statistics

false

Should DataFusion collect statistics after listing files

datafusion.execution.target_partitions

0

Number of partitions for query execution. Increasing partitions can increase concurrency. Defaults to the number of cpu cores on the system

datafusion.execution.time_zone

+00:00

The default time zone Some functions, e.g. EXTRACT(HOUR from SOME_TIME), shift the underlying datetime according to this time zone, and then extract the hour

datafusion.execution.parquet.enable_page_index

false

If true, uses parquet data page level metadata (Page Index) statistics to reduce the number of rows decoded.

datafusion.execution.parquet.pruning

true

If true, the parquet reader attempts to skip entire row groups based on the predicate in the query and the metadata (min/max values) stored in the parquet file

datafusion.execution.parquet.skip_metadata

true

If true, the parquet reader skip the optional embedded metadata that may be in the file Schema. This setting can help avoid schema conflicts when querying multiple parquet files with schemas containing compatible types but different metadata

datafusion.execution.parquet.metadata_size_hint

NULL

If specified, the parquet reader will try and fetch the last size_hint bytes of the parquet file optimistically. If not specified, two read are required: One read to fetch the 8-byte parquet footer and another to fetch the metadata length encoded in the footer

datafusion.execution.parquet.pushdown_filters

false

If true, filter expressions are be applied during the parquet decoding operation to reduce the number of rows decoded

datafusion.execution.parquet.reorder_filters

false

If true, filter expressions evaluated during the parquet decoding operation will be reordered heuristically to minimize the cost of evaluation. If false, the filters are applied in the same order as written in the query

datafusion.optimizer.enable_round_robin_repartition

true

When set to true, the physical plan optimizer will try to add round robin repartition to increase parallelism to leverage more CPU cores

datafusion.optimizer.filter_null_join_keys

false

When set to true, the optimizer will insert filters before a join between a nullable and non-nullable column to filter out nulls on the nullable side. This filter can add additional overhead when the file format does not fully support predicate push down.

datafusion.optimizer.repartition_aggregations

true

Should DataFusion repartition data using the aggregate keys to execute aggregates in parallel using the provided target_partitions level”

datafusion.optimizer.repartition_file_min_size

10485760

Minimum total files size in bytes to perform file scan repartitioning.

datafusion.optimizer.repartition_joins

true

Should DataFusion repartition data using the join keys to execute joins in parallel using the provided target_partitions level”

datafusion.optimizer.repartition_file_scans

false

When set to true, file groups will be repartitioned to achieve maximum parallelism. Currently supported only for Parquet format in which case multiple row groups from the same file may be read concurrently. If false then each row group is read serially, though different files may be read in parallel.

datafusion.optimizer.repartition_windows

true

Should DataFusion repartition data using the partitions keys to execute window functions in parallel using the provided target_partitions level”

datafusion.optimizer.repartition_sorts

true

Should DataFusion execute sorts in a per-partition fashion and merge afterwards instead of coalescing first and sorting globally With this flag is enabled, plans in the form below “SortExec: [a@0 ASC]”, ” CoalescePartitionsExec”, ” RepartitionExec: partitioning=RoundRobinBatch(8), input_partitions=1”, would turn into the plan below which performs better in multithreaded environments “SortPreservingMergeExec: [a@0 ASC]”, ” SortExec: [a@0 ASC]”, ” RepartitionExec: partitioning=RoundRobinBatch(8), input_partitions=1”,

datafusion.optimizer.skip_failed_rules

true

When set to true, the logical plan optimizer will produce warning messages if any optimization rules produce errors and then proceed to the next rule. When set to false, any rules that produce errors will cause the query to fail

datafusion.optimizer.max_passes

3

Number of times that the optimizer will attempt to optimize the plan

datafusion.optimizer.top_down_join_key_reordering

true

When set to true, the physical plan optimizer will run a top down process to reorder the join keys

datafusion.optimizer.prefer_hash_join

true

When set to true, the physical plan optimizer will prefer HashJoin over SortMergeJoin. HashJoin can work more efficiently than SortMergeJoin but consumes more memory

datafusion.optimizer.hash_join_single_partition_threshold

1048576

The maximum estimated size in bytes for one input side of a HashJoin will be collected into a single partition

datafusion.explain.logical_plan_only

false

When set to true, the explain statement will only print logical plans

datafusion.explain.physical_plan_only

false

When set to true, the explain statement will only print physical plans

datafusion.sql_parser.parse_float_as_decimal

false

When set to true, sql parser will parse float as decimal type

datafusion.sql_parser.enable_ident_normalization

true

When set to true, sql parser will normalize ident(convert ident to lowercase when not quoted)

-
- - -
- - - -
- - -
-

previous

-

Status

-
- - -
-

next

-

Frequently Asked Questions

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/dataframe.html b/datafusion/user-guide/dataframe.html deleted file mode 100644 index 7e1e20c1e142..000000000000 --- a/datafusion/user-guide/dataframe.html +++ /dev/null @@ -1,535 +0,0 @@ - - - - - - - - - DataFrame API — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

DataFrame API

-

A DataFrame represents a logical set of rows with the same named columns, similar to a Pandas DataFrame or -Spark DataFrame.

-

DataFrames are typically created by calling a method on -SessionContext, such as read_csv, and can then be modified -by calling the transformation methods, such as filter, select, aggregate, and limit -to build up a query definition.

-

The query can be executed by calling the collect method.

-

The DataFrame struct is part of DataFusion’s prelude and can be imported with the following statement.

-
use datafusion::prelude::*;
-
-
-

Here is a minimal example showing the execution of a query using the DataFrame API.

-
let ctx = SessionContext::new();
-let df = ctx.read_csv("tests/data/example.csv", CsvReadOptions::new()).await?;
-let df = df.filter(col("a").lt_eq(col("b")))?
-           .aggregate(vec![col("a")], vec![min(col("b"))])?
-           .limit(0, Some(100))?;
-// Print results
-df.show();
-
-
-

The DataFrame API is well documented in the API reference on docs.rs.

-

Refer to the Expressions Reference for available functions for building logical expressions for use with the -DataFrame API.

-
-

DataFrame Transformations

-

These methods create a new DataFrame after applying a transformation to the logical plan that the DataFrame represents.

-

DataFusion DataFrames use lazy evaluation, meaning that each transformation is just creating a new query plan and -not actually performing any transformations. This approach allows for the overall plan to be optimized before -execution. The plan is evaluated (executed) when an action method is invoked, such as collect.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Function

Notes

aggregate

Perform an aggregate query with optional grouping expressions.

distinct

Filter out duplicate rows.

except

Calculate the exception of two DataFrames. The two DataFrames must have exactly the same schema

filter

Filter a DataFrame to only include rows that match the specified filter expression.

intersect

Calculate the intersection of two DataFrames. The two DataFrames must have exactly the same schema

join

Join this DataFrame with another DataFrame using the specified columns as join keys.

join_on

Join this DataFrame with another DataFrame using arbitrary expressions.

limit

Limit the number of rows returned from this DataFrame.

repartition

Repartition a DataFrame based on a logical partitioning scheme.

sort

Sort the DataFrame by the specified sorting expressions. Any expression can be turned into a sort expression by calling its sort method.

select

Create a projection based on arbitrary expressions. Example: df..select(vec![col("c1"), abs(col("c2"))])?

select_columns

Create a projection based on column names. Example: df.select_columns(&["id", "name"])?.

union

Calculate the union of two DataFrames, preserving duplicate rows. The two DataFrames must have exactly the same schema.

union_distinct

Calculate the distinct union of two DataFrames. The two DataFrames must have exactly the same schema.

with_column

Add an additional column to the DataFrame.

with_column_renamed

Rename one column by applying a new projection.

-
-
-

DataFrame Actions

-

These methods execute the logical plan represented by the DataFrame and either collects the results into memory, prints them to stdout, or writes them to disk.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Function

Notes

collect

Executes this DataFrame and collects all results into a vector of RecordBatch.

collect_partitioned

Executes this DataFrame and collects all results into a vector of vector of RecordBatch maintaining the input partitioning.

count

Executes this DataFrame to get the total number of rows.

execute_stream

Executes this DataFrame and returns a stream over a single partition.

execute_stream_partitioned

Executes this DataFrame and returns one stream per partition.

show

Execute this DataFrame and print the results to stdout.

show_limit

Execute this DataFrame and print a subset of results to stdout.

write_csv

Execute this DataFrame and write the results to disk in CSV format.

write_json

Execute this DataFrame and write the results to disk in JSON format.

write_parquet

Execute this DataFrame and write the results to disk in Parquet format.

-
-
-

Other DataFrame Methods

- - - - - - - - - - - - - - - - - - - - - - - -

Function

Notes

explain

Return a DataFrame with the explanation of its plan so far.

registry

Return a FunctionRegistry used to plan udf’s calls.

schema

Returns the schema describing the output of this DataFrame in terms of columns returned, where each column has a name, data type, and nullability attribute.

to_logical_plan

Return the optimized logical plan represented by this DataFrame.

to_unoptimized_plan

Return the unoptimized logical plan represented by this DataFrame.

-
-
- - -
- - - -
- - -
-

previous

-

DataFusion Command-line SQL Utility

-
- - -
-

next

-

Expressions

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/example-usage.html b/datafusion/user-guide/example-usage.html deleted file mode 100644 index a997783dfbfd..000000000000 --- a/datafusion/user-guide/example-usage.html +++ /dev/null @@ -1,533 +0,0 @@ - - - - - - - - - Example Usage — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Example Usage

-

In this example some simple processing is performed on the example.csv file.

-
-

Update Cargo.toml

-

Add the following to your Cargo.toml file:

-
datafusion = "11.0"
-tokio = "1.0"
-
-
-
-
-

Run a SQL query against data stored in a CSV:

-
use datafusion::prelude::*;
-
-#[tokio::main]
-async fn main() -> datafusion::error::Result<()> {
-  // register the table
-  let ctx = SessionContext::new();
-  ctx.register_csv("example", "tests/data/example.csv", CsvReadOptions::new()).await?;
-
-  // create a plan to run a SQL query
-  let df = ctx.sql("SELECT a, MIN(b) FROM example GROUP BY a LIMIT 100").await?;
-
-  // execute and print results
-  df.show().await?;
-  Ok(())
-}
-
-
-
-
-

Use the DataFrame API to process data stored in a CSV:

-
use datafusion::prelude::*;
-
-#[tokio::main]
-async fn main() -> datafusion::error::Result<()> {
-  // create the dataframe
-  let ctx = SessionContext::new();
-  let df = ctx.read_csv("tests/data/example.csv", CsvReadOptions::new()).await?;
-
-  let df = df.filter(col("a").lt_eq(col("b")))?
-           .aggregate(vec![col("a")], vec![min(col("b"))])?
-           .limit(0, Some(100))?;
-
-  // execute and print results
-  df.show().await?;
-  Ok(())
-}
-
-
-
-
-

Output from both examples

-
+---+--------+
-| a | MIN(b) |
-+---+--------+
-| 1 | 2      |
-+---+--------+
-
-
-
-
-
-

Identifiers and Capitalization

-

Please be aware that all identifiers are effectively made lower-case in SQL, so if your csv file has capital letters (ex: Name) you must put your column name in double quotes or the examples won’t work.

-

To illustrate this behavior, consider the capitalized_example.csv file:

-
-

Run a SQL query against data stored in a CSV:

-
use datafusion::prelude::*;
-
-#[tokio::main]
-async fn main() -> datafusion::error::Result<()> {
-  // register the table
-  let ctx = SessionContext::new();
-  ctx.register_csv("example", "tests/data/capitalized_example.csv", CsvReadOptions::new()).await?;
-
-  // create a plan to run a SQL query
-  let df = ctx.sql("SELECT \"A\", MIN(b) FROM example GROUP BY \"A\" LIMIT 100").await?;
-
-  // execute and print results
-  df.show().await?;
-  Ok(())
-}
-
-
-
-
-

Use the DataFrame API to process data stored in a CSV:

-
use datafusion::prelude::*;
-
-#[tokio::main]
-async fn main() -> datafusion::error::Result<()> {
-  // create the dataframe
-  let ctx = SessionContext::new();
-  let df = ctx.read_csv("tests/data/capitalized_example.csv", CsvReadOptions::new()).await?;
-
-  let df = df.filter(col("A").lt_eq(col("c")))?
-           .aggregate(vec![col("A")], vec![min(col("b"))])?
-           .limit(0, Some(100))?;
-
-  // execute and print results
-  df.show().await?;
-  Ok(())
-}
-
-
-
-
-

Output from both examples

-
+---+--------+
-| A | MIN(b) |
-+---+--------+
-| 2 | 1      |
-| 1 | 2      |
-+---+--------+
-
-
-
-
- - -
- - - -
- - -
-

previous

-

Introduction

-
- - -
-

next

-

Using DataFusion as a library

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/expressions.html b/datafusion/user-guide/expressions.html deleted file mode 100644 index 3465eeaa35e4..000000000000 --- a/datafusion/user-guide/expressions.html +++ /dev/null @@ -1,933 +0,0 @@ - - - - - - - - - Expressions — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Expressions

-

DataFrame methods such as select and filter accept one or more logical expressions and there are many functions -available for creating logical expressions. These are documented below.

-

Expressions can be chained together using a fluent-style API:

-
// create the expression `(a > 6) AND (b < 7)`
-col("a").gt(lit(6)).and(col("b").lt(lit(7)))
-
-
-
-

Identifiers

- - - - - - - - - - - -

Function

Notes

col

Reference a column in a dataframe col("a")

-
-
-

Literal Values

- - - - - - - - - - - -

Function

Notes

lit

Literal value such as lit(123) or lit("hello")

-
-
-

Boolean Expressions

- - - - - - - - - - - - - - - - - -

Function

Notes

and

and(expr1, expr2) or expr1.and(expr2)

or

or(expr1, expr2) or expr1.or(expr2)

not

not(expr) or expr.not()

-
-
-

Comparison Expressions

- - - - - - - - - - - - - - - - - - - - - - - - - - -

Function

Notes

eq

expr1.eq(expr2)

gt

expr1.gt(expr2)

gt_eq

expr1.gt_eq(expr2)

lt

expr1.lt(expr2)

lt_eq

expr1.lt_eq(expr2)

not_eq

expr1.not_eq(expr2)

-
-
-

Math Functions

-

In addition to the math functions listed here, some Rust operators are implemented for expressions, allowing -expressions such as col("a") + col("b") to be used.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Function

Notes

abs(x)

absolute value

acos(x)

inverse cosine

asin(x)

inverse sine

atan(x)

inverse tangent

atan2(y, x)

inverse tangent of y / x

ceil(x)

nearest integer greater than or equal to argument

cos(x)

cosine

exp(x)

exponential

floor(x)

nearest integer less than or equal to argument

ln(x)

natural logarithm

log10(x)

base 10 logarithm

log2(x)

base 2 logarithm

power(base, exponent)

base raised to the power of exponent

round(x)

round to nearest integer

signum(x)

sign of the argument (-1, 0, +1)

sin(x)

sine

sqrt(x)

square root

tan(x)

tangent

trunc(x)

truncate toward zero

-
-
-

Bitwise Operators

- - - - - - - - - - - - - - - - - - - - - - - -

Operator

Notes

&

Bitwise AND => (expr1 & expr2)

|

Bitwise OR => (expr1 | expr2)

#

Bitwise XOR => (expr1 # expr2)

<<

Bitwise left shift => (expr1 << expr2)

>>

Bitwise right shift => (expr1 << expr2)

-
-
-

Conditional Expressions

- - - - - - - - - - - - - - - - - -

Function

Notes

coalesce

Returns the first of its arguments that is not null. Null is returned only if all arguments are null. It is often used to substitute a default value for null values when data is retrieved for display.

case

CASE expression. Example: case(expr).when(expr, expr).when(expr, expr).otherwise(expr).end().

nullif

Returns a null value if value1 equals value2; otherwise it returns value1. This can be used to perform the inverse operation of the coalesce expression.

-
-
-

String Expressions

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Function

Notes

ascii

bit_length

btrim

char_length

character_length

concat

concat_ws

chr

initcap

left

length

lower

lpad

ltrim

md5

octet_length

repeat

replace

reverse

right

rpad

rtrim

digest

split_part

starts_with

strpos

substr

translate

trim

upper

-
-
-

Regular Expressions

- - - - - - - - - - - - - - -

Function

Notes

regexp_match

regexp_replace

-
-
-

Temporal Expressions

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Function

Notes

date_part

date_trunc

from_unixtime

to_timestamp

to_timestamp_millis

to_timestamp_micros

to_timestamp_seconds

now()

current time

-
-
-

Other Expressions

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Function

Notes

array

in_list

random

sha224

sha256

sha384

sha512

struct

to_hex

-
-
-

Aggregate Functions

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Function

Notes

avg

approx_distinct

approx_median

approx_percentile_cont

approx_percentile_cont_with_weight

count

count_distinct

cube

grouping_set

max

median

min

rollup

sum

-
-
-

Subquery Expressions

- - - - - - - - - - - - - - - - - - - - - - - -

Function

Notes

exists

in_subquery

df1.filter(in_subquery(col("foo"), df2))? is the equivalent of the SQL WHERE foo IN <df2>

not_exists

not_in_subquery

scalar_subquery

-
-
-

User-Defined Function Expressions

- - - - - - - - - - - - - - -

Function

Notes

create_udf

create_udaf

-
-
- - -
- - - -
- - -
-

previous

-

DataFrame API

-
- - -
-

next

-

SQL Reference

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/faq.html b/datafusion/user-guide/faq.html deleted file mode 100644 index f6ec5683043b..000000000000 --- a/datafusion/user-guide/faq.html +++ /dev/null @@ -1,376 +0,0 @@ - - - - - - - - - Frequently Asked Questions — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Frequently Asked Questions

-
-

What is the relationship between Apache Arrow, DataFusion, and Ballista?

-

Apache Arrow is a library which provides a standardized memory representation for columnar data. It also provides -“kernels” for performing common operations on this data.

-

DataFusion is a library for executing queries in-process using the Apache Arrow memory -model and computational kernels. It is designed to run within a single process, using threads -for parallel query execution.

-

Ballista is a distributed compute platform built on DataFusion.

-
-
- - -
- - - -
- - -
-

previous

-

Configuration Settings

-
- - -
-

next

-

Introduction

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/introduction.html b/datafusion/user-guide/introduction.html deleted file mode 100644 index eacb0d9f2dcb..000000000000 --- a/datafusion/user-guide/introduction.html +++ /dev/null @@ -1,395 +0,0 @@ - - - - - - - - - Introduction — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Introduction

-

DataFusion is an extensible query execution framework, written in -Rust, that uses Apache Arrow as its -in-memory format.

-

DataFusion supports SQL and a DataFrame API for building logical query -plans, an extensive query optimizer, and a multi-threaded parallel -execution execution engine for processing partitioned data sources -such as CSV and Parquet files extremely quickly.

-
-

Use Cases

-

DataFusion is used to create modern, fast and efficient data -pipelines, ETL processes, and database systems, which need the -performance of Rust and Apache Arrow and want to provide their users -the convenience of an SQL interface or a DataFrame API.

-
-
-

Why DataFusion?

-
    -

  • High Performance: Leveraging Rust and Arrow’s memory model, DataFusion is very fast.

    • -

  • Easy to Connect: Being part of the Apache Arrow ecosystem (Arrow, Parquet and Flight), DataFusion works well with the rest of the big data ecosystem

    • -

  • Easy to Embed: Allowing extension at almost any point in its design, DataFusion can be tailored for your specific usecase

    • -

  • High Quality: Extensively tested, both by itself and with the rest of the Arrow ecosystem, DataFusion can be used as the foundation for production systems.

    • -
-
-
- - -
- - - -
- - -
-

previous

-

Apache Arrow DataFusion

-
- - -
-

next

-

Example Usage

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/library.html b/datafusion/user-guide/library.html deleted file mode 100644 index b3b843437d63..000000000000 --- a/datafusion/user-guide/library.html +++ /dev/null @@ -1,489 +0,0 @@ - - - - - - - - - Using DataFusion as a library — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Using DataFusion as a library

-
-

Create a new project

-
cargo new hello_datafusion
-
-
-
$ cd hello_datafusion
-$ tree .
-.
-├── Cargo.toml
-└── src
-    └── main.rs
-
-1 directory, 2 files
-
-
-
-
-

Default Configuration

-

DataFusion is published on crates.io, and is well documented on docs.rs.

-

To get started, add the following to your Cargo.toml file:

-
[dependencies]
-datafusion = "11.0"
-
-
-
-
-

Create a main function

-

Update the main.rs file with your first datafusion application based on Example usage

-
use datafusion::prelude::*;
-
-#[tokio::main]
-async fn main() -> datafusion::error::Result<()> {
-  // register the table
-  let ctx = SessionContext::new();
-  ctx.register_csv("test", "<PATH_TO_YOUR_CSV_FILE>", CsvReadOptions::new()).await?;
-
-  // create a plan to run a SQL query
-  let df = ctx.sql("SELECT * FROM test").await?;
-
-  // execute and print results
-  df.show().await?;
-  Ok(())
-}
-
-
-
-
-

Extensibility

-

DataFusion is designed to be extensible at all points. To that end, you can provide your own custom:

-
    -

  • User Defined Functions (UDFs)

    • -

  • User Defined Aggregate Functions (UDAFs)

    • -

  • User Defined Table Source (TableProvider) for tables

    • -

  • User Defined Optimizer passes (plan rewrites)

    • -

  • User Defined LogicalPlan nodes

    • -

  • User Defined ExecutionPlan nodes

    • -
-
-
-

Rust Version Compatibility

-

This crate is tested with the latest stable version of Rust. We do not currently test against other, older versions of the Rust compiler.

-
-
-

Optimized Configuration

-

For an optimized build several steps are required. First, use the below in your Cargo.toml. It is -worth noting that using the settings in the [profile.release] section will significantly increase the build time.

-
[dependencies]
-datafusion = { version = "11.0" , features = ["simd"]}
-tokio = { version = "^1.0", features = ["rt-multi-thread"] }
-snmalloc-rs = "0.2"
-
-[profile.release]
-lto = true
-codegen-units = 1
-
-
-

Then, in main.rs. update the memory allocator with the below after your imports:

-
use datafusion::prelude::*;
-
-#[global_allocator]
-static ALLOC: snmalloc_rs::SnMalloc = snmalloc_rs::SnMalloc;
-
-async fn main() -> datafusion::error::Result<()> {
-  Ok(())
-}
-
-
-

Finally, in order to build with the simd optimization cargo nightly is required.

-
rustup toolchain install nightly
-
-
-

Based on the instruction set architecture you are building on you will want to configure the target-cpu as well, ideally -with native or at least avx2.

-
RUSTFLAGS='-C target-cpu=native' cargo +nightly run --release
-
-
-
-
- - -
- - - -
- - -
-

previous

-

Example Usage

-
- - -
-

next

-

DataFusion Command-line SQL Utility

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/sql/aggregate_functions.html b/datafusion/user-guide/sql/aggregate_functions.html deleted file mode 100644 index c1274faf1cf6..000000000000 --- a/datafusion/user-guide/sql/aggregate_functions.html +++ /dev/null @@ -1,445 +0,0 @@ - - - - - - - - - Aggregate Functions — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Aggregate Functions

-

Aggregate functions operate on a set of values to compute a single result. Please refer to PostgreSQL for usage of standard SQL functions.

-
-

General

-
    -

  • min

    • -

  • max

    • -

  • count

    • -

  • avg

    • -

  • sum

    • -

  • array_agg

    • -
-
-
-

Statistical

-
    -

  • var / var_samp / var_pop

    • -

  • stddev / stddev_samp / stddev_pop

    • -

  • covar / covar_samp / covar_pop

    • -

  • corr

    • -
-
-
-

Approximate

-
-

approx_distinct

-

approx_distinct(x) -> uint64 returns the approximate number (HyperLogLog) of distinct input values

-
-
-

approx_median

-

approx_median(x) -> x returns the approximate median of input values. it is an alias of approx_percentile_cont(x, 0.5).

-
-
-

approx_percentile_cont

-

approx_percentile_cont(x, p) -> x return the approximate percentile (TDigest) of input values, where p is a float64 between 0 and 1 (inclusive).

-

It supports raw data as input and build Tdigest sketches during query time, and is approximately equal to approx_percentile_cont_with_weight(x, 1, p).

-

approx_percentile_cont(x, p, n) -> x return the approximate percentile (TDigest) of input values, where p is a float64 between 0 and 1 (inclusive),

-

and n (default 100) is the number of centroids in Tdigest which means that if there are n or fewer unique values in x, you can expect an exact result.

-

A higher value of n results in a more accurate approximation and the cost of higher memory usage.

-
-
-

approx_percentile_cont_with_weight

-

approx_percentile_cont_with_weight(x, w, p) -> x returns the approximate percentile (TDigest) of input values with weight, where w is weight column expression and p is a float64 between 0 and 1 (inclusive).

-

It supports raw data as input or pre-aggregated TDigest sketches, then builds or merges Tdigest sketches during query time. TDigest sketches are a list of centroid (x, w), where x stands for mean and w stands for weight.

-

It is suitable for low latency OLAP system where a streaming compute engine (e.g. Spark Streaming/Flink) pre-aggregates data to a data store, then queries using Datafusion.

-
-
-
- - -
- - - -
- - -
-

previous

-

Information Schema

-
- - -
-

next

-

Scalar Functions

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/sql/data_types.html b/datafusion/user-guide/sql/data_types.html deleted file mode 100644 index acfead9679e5..000000000000 --- a/datafusion/user-guide/sql/data_types.html +++ /dev/null @@ -1,594 +0,0 @@ - - - - - - - - - Data Types — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Data Types

-

DataFusion uses Arrow, and thus the Arrow type system, for query -execution. The SQL types from -sqlparser-rs -are mapped to Arrow data types according to the following table. -This mapping occurs when defining the schema in a CREATE EXTERNAL TABLE command or when performing a SQL CAST operation.

-

You can see the corresponding Arrow type for any SQL expression using -the arrow_typeof function. For example:

-
❯ select arrow_typeof(interval '1 month');
-+-------------------------------------+
-| arrowtypeof(IntervalYearMonth("1")) |
-+-------------------------------------+
-| Interval(YearMonth)                 |
-+-------------------------------------+
-
-
-
-

Character Types

- - - - - - - - - - - - - - - - - - - - -

SQL DataType

Arrow DataType

CHAR

Utf8

VARCHAR

Utf8

TEXT

Utf8

STRING

Utf8

-
-
-

Numeric Types

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

SQL DataType

Arrow DataType

Notes

TINYINT

Int8

SMALLINT

Int16

INT or INTEGER

Int32

BIGINT

Int64

TINYINT UNSIGNED

UInt8

SMALLINT UNSIGNED

UInt16

INT UNSIGNED or INTEGER UNSIGNED

UInt32

BIGINT UNSIGNED

UInt64

FLOAT

Float32

REAL

Float32

DOUBLE

Float64

DECIMAL(precision,scale)

Decimal128(precision,scale)

Decimal support is currently experimental (#3523)

-
-
-

Date/Time Types

- - - - - - - - - - - - - - - - - - - - -

SQL DataType

Arrow DataType

DATE

Date32

TIME

Time64(TimeUnit::Nanosecond)

TIMESTAMP

Timestamp(TimeUnit::Nanosecond, None)

INTERVAL

Interval(IntervalUnit::YearMonth) or Interval(IntervalUnit::DayTime)

-
-
-

Boolean Types

- - - - - - - - - - - -

SQL DataType

Arrow DataType

BOOLEAN

Boolean

-
-
-

Binary Types

- - - - - - - - - - - -

SQL DataType

Arrow DataType

BYTEA

Binary

-
-
-

Unsupported Types

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

SQL Data Type

Arrow DataType

UUID

Not yet supported

BLOB

Not yet supported

CLOB

Not yet supported

BINARY

Not yet supported

VARBINARY

Not yet supported

REGCLASS

Not yet supported

NVARCHAR

Not yet supported

CUSTOM

Not yet supported

ARRAY

Not yet supported

ENUM

Not yet supported

SET

Not yet supported

DATETIME

Not yet supported

-
-
- - -
- - - -
- - -
-

previous

-

SQL Reference

-
- - -
-

next

-

SELECT syntax

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/sql/ddl.html b/datafusion/user-guide/sql/ddl.html deleted file mode 100644 index 3f3e808f43fc..000000000000 --- a/datafusion/user-guide/sql/ddl.html +++ /dev/null @@ -1,504 +0,0 @@ - - - - - - - - - DDL — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

DDL

-
-

CREATE EXTERNAL TABLE

-

Parquet data sources can be registered by executing a CREATE EXTERNAL TABLE SQL statement. It is not necessary -to provide schema information for Parquet files.

-
CREATE EXTERNAL TABLE taxi
-STORED AS PARQUET
-LOCATION '/mnt/nyctaxi/tripdata.parquet';
-
-
-

CSV data sources can also be registered by executing a CREATE EXTERNAL TABLE SQL statement. The schema will be -inferred based on scanning a subset of the file.

-
CREATE EXTERNAL TABLE test
-STORED AS CSV
-WITH HEADER ROW
-LOCATION '/path/to/aggregate_simple.csv';
-
-
-

It is also possible to specify the schema manually.

-
CREATE EXTERNAL TABLE test (
-    c1  VARCHAR NOT NULL,
-    c2  INT NOT NULL,
-    c3  SMALLINT NOT NULL,
-    c4  SMALLINT NOT NULL,
-    c5  INT NOT NULL,
-    c6  BIGINT NOT NULL,
-    c7  SMALLINT NOT NULL,
-    c8  INT NOT NULL,
-    c9  BIGINT NOT NULL,
-    c10 VARCHAR NOT NULL,
-    c11 FLOAT NOT NULL,
-    c12 DOUBLE NOT NULL,
-    c13 VARCHAR NOT NULL
-)
-STORED AS CSV
-WITH HEADER ROW
-LOCATION '/path/to/aggregate_test_100.csv';
-
-
-

If data sources are already partitioned in Hive style, PARTITIONED BY can be used for partition pruning.

-
/mnt/nyctaxi/year=2022/month=01/tripdata.parquet
-/mnt/nyctaxi/year=2021/month=12/tripdata.parquet
-/mnt/nyctaxi/year=2021/month=11/tripdata.parquet
-
-
-
CREATE EXTERNAL TABLE taxi
-STORED AS PARQUET
-PARTITIONED BY (year, month)
-LOCATION '/mnt/nyctaxi';
-
-
-
-
-

CREATE TABLE

-

An in-memory table can be created with a query or values list.

-
-CREATE [OR REPLACE] TABLE [IF NOT EXISTS] table_name AS [SELECT | VALUES LIST];
-
-
CREATE TABLE IF NOT EXISTS valuetable AS VALUES(1,'HELLO'),(12,'DATAFUSION');
-
-CREATE TABLE memtable as select * from valuetable;
-
-
-
-
-

DROP TABLE

-

Removes the table from DataFusion’s catalog.

-
-DROP TABLE [ IF EXISTS ] table_name;
-
-
CREATE TABLE users AS VALUES(1,2),(2,3);
-DROP TABLE users;
--- or use 'if exists' to silently ignore if the table doesn't exist
-DROP TABLE IF EXISTS nonexistent_table;
-
-
-
-
-

CREATE VIEW

-

View is a virtual table based on the result of a SQL query. It can be created from an existing table or values list.

-
-CREATE VIEW view_name AS statement;
-
-
CREATE TABLE users AS VALUES(1,2),(2,3),(3,4),(4,5);
-CREATE VIEW test AS SELECT column1 FROM users;
-SELECT * FROM test;
-+---------+
-| column1 |
-+---------+
-| 1       |
-| 2       |
-| 3       |
-| 4       |
-+---------+
-
-
-
CREATE VIEW test AS VALUES(1,2),(5,6);
-SELECT * FROM test;
-+---------+---------+
-| column1 | column2 |
-+---------+---------+
-| 1       | 2       |
-| 5       | 6       |
-+---------+---------+
-
-
-
-
-

DROP VIEW

-

Removes the view from DataFusion’s catalog.

-
-DROP VIEW [ IF EXISTS ] view_name;
-
-
-- drop users_v view from the customer_a schema
-DROP VIEW IF EXISTS customer_a.users_v;
-
-
-
-
- - -
- - - -
- - -
-

previous

-

Subqueries

-
- - -
-

next

-

EXPLAIN

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/sql/explain.html b/datafusion/user-guide/sql/explain.html deleted file mode 100644 index 97fb05a36ac8..000000000000 --- a/datafusion/user-guide/sql/explain.html +++ /dev/null @@ -1,419 +0,0 @@ - - - - - - - - - EXPLAIN — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

EXPLAIN

-

The EXPLAIN command shows the logical and physical execution plan for the specified SQL statement.

-
-EXPLAIN [ANALYZE] [VERBOSE] statement
-
-
-

EXPLAIN

-

Shows the execution plan of a statement. -If you need more details output, try to use EXPLAIN VERBOSE.

-
EXPLAIN SELECT SUM(x) FROM table GROUP BY b;
-+---------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| plan_type     | plan                                                                                                                                                           |
-+---------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| logical_plan  | Projection: #SUM(table.x)                                                                                                                                        |
-|               |   Aggregate: groupBy=[[#table.b]], aggr=[[SUM(#table.x)]]                                                                                                          |
-|               |     TableScan: table projection=[x, b]                                                                                                                           |
-| physical_plan | ProjectionExec: expr=[SUM(table.x)@1 as SUM(table.x)]                                                                                                              |
-|               |   AggregateExec: mode=FinalPartitioned, gby=[b@0 as b], aggr=[SUM(table.x)]                                                                                      |
-|               |     CoalesceBatchesExec: target_batch_size=4096                                                                                                                |
-|               |       RepartitionExec: partitioning=Hash([Column { name: "b", index: 0 }], 16)                                                                                 |
-|               |         AggregateExec: mode=Partial, gby=[b@1 as b], aggr=[SUM(table.x)]                                                                                         |
-|               |           RepartitionExec: partitioning=RoundRobinBatch(16)                                                                                                    |
-|               |             CsvExec: source=Path(/tmp/table.csv: [/tmp/table.csv]), has_header=false, limit=None, projection=[x, b]                                            |
-|               |                                                                                                                                                                |
-+---------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
-
-
-
-
-

EXPLAIN ANALYZE

-

Shows the execution plan and metrics of a statement. -If you need more information output, try to use EXPLAIN ANALYZE VERBOSE.

-
EXPLAIN ANALYZE SELECT SUM(x) FROM table GROUP BY b;
-+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| plan_type         | plan                                                                                                                                                      |
-+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+
-| Plan with Metrics | CoalescePartitionsExec, metrics=[]                                                                                                                        |
-|                   |   ProjectionExec: expr=[SUM(table.x)@1 as SUM(x)], metrics=[]                                                                                             |
-|                   |     HashAggregateExec: mode=FinalPartitioned, gby=[b@0 as b], aggr=[SUM(x)], metrics=[outputRows=2]                                                       |
-|                   |       CoalesceBatchesExec: target_batch_size=4096, metrics=[]                                                                                             |
-|                   |         RepartitionExec: partitioning=Hash([Column { name: "b", index: 0 }], 16), metrics=[sendTime=839560, fetchTime=122528525, repartitionTime=5327877] |
-|                   |           HashAggregateExec: mode=Partial, gby=[b@1 as b], aggr=[SUM(x)], metrics=[outputRows=2]                                                          |
-|                   |             RepartitionExec: partitioning=RoundRobinBatch(16), metrics=[fetchTime=5660489, repartitionTime=0, sendTime=8012]                              |
-|                   |               CsvExec: source=Path(/tmp/table.csv: [/tmp/table.csv]), has_header=false, metrics=[]                                                        |
-+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+
-
-
-
-
- - -
- - - -
- - -
-

previous

-

DDL

-
- - -
-

next

-

Information Schema

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/sql/index.html b/datafusion/user-guide/sql/index.html deleted file mode 100644 index b5ff3eb84e11..000000000000 --- a/datafusion/user-guide/sql/index.html +++ /dev/null @@ -1,408 +0,0 @@ - - - - - - - - - SQL Reference — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- - - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- - - - - -
- - -
-

previous

-

Expressions

-
- - -
-

next

-

Data Types

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/sql/information_schema.html b/datafusion/user-guide/sql/information_schema.html deleted file mode 100644 index 1e9fb2e6b8f5..000000000000 --- a/datafusion/user-guide/sql/information_schema.html +++ /dev/null @@ -1,401 +0,0 @@ - - - - - - - - - Information Schema — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- - - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Information Schema

-

DataFusion supports showing metadata about the tables and views available. This information can be accessed using the -views of the ISO SQL information_schema schema or the DataFusion specific SHOW TABLES and SHOW COLUMNS commands.

-

To show tables in the DataFusion catalog, use the SHOW TABLES command or the information_schema.tables view:

-
> show tables;
-or
-> select * from information_schema.tables;
-+---------------+--------------------+------------+------------+
-| table_catalog | table_schema       | table_name | table_type |
-+---------------+--------------------+------------+------------+
-| datafusion    | public             | t          | BASE TABLE |
-| datafusion    | information_schema | tables     | VIEW       |
-| datafusion    | information_schema | views      | VIEW       |
-| datafusion    | information_schema | columns    | VIEW       |
-+---------------+--------------------+------------+------------+
-
-
-

To show the schema of a table in DataFusion, use the SHOW COLUMNS command or the information_schema.columns view:

-
> show columns from t;
-or
-> select table_catalog, table_schema, table_name, column_name, data_type, is_nullable from information_schema.columns;
-+---------------+--------------+------------+-------------+-----------+-------------+
-| table_catalog | table_schema | table_name | column_name | data_type | is_nullable |
-+---------------+--------------+------------+-------------+-----------+-------------+
-| datafusion    | public       | t          | Int64(1)    | Int64     | NO          |
-+---------------+--------------+------------+-------------+-----------+-------------+
-
-
-

To show the current session configuration options, use the SHOW ALL command or the information_schema.df_settings view:

-
❯ select * from information_schema.df_settings;
-
-+-------------------------------------------------+---------+
-| name                                            | setting |
-+-------------------------------------------------+---------+
-| datafusion.execution.batch_size                 | 8192    |
-| datafusion.execution.coalesce_batches           | true    |
-| datafusion.execution.coalesce_target_batch_size | 4096    |
-| datafusion.execution.time_zone                  | UTC     |
-| datafusion.explain.logical_plan_only            | false   |
-| datafusion.explain.physical_plan_only           | false   |
-| datafusion.optimizer.filter_null_join_keys      | false   |
-| datafusion.optimizer.skip_failed_rules          | true    |
-+-------------------------------------------------+---------+
-
-
-
- - -
- - - -
- - -
-

previous

-

EXPLAIN

-
- - -
-

next

-

Aggregate Functions

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/sql/scalar_functions.html b/datafusion/user-guide/sql/scalar_functions.html deleted file mode 100644 index e7d52208925a..000000000000 --- a/datafusion/user-guide/sql/scalar_functions.html +++ /dev/null @@ -1,1418 +0,0 @@ - - - - - - - - - Scalar Functions — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Scalar Functions

-
-

Math Functions

-
-

abs(x)

-

absolute value

-
-
-

acos(x)

-

inverse cosine

-
-
-

asin(x)

-

inverse sine

-
-
-

atan(x)

-

inverse tangent

-
-
-

atan2(y, x)

-

inverse tangent of y / x

-
-
-

ceil(x)

-

nearest integer greater than or equal to argument

-
-
-

cos(x)

-

cosine

-
-
-

exp(x)

-

exponential

-
-
-

floor(x)

-

nearest integer less than or equal to argument

-
-
-

ln(x)

-

natural logarithm

-
-
-

log10(x)

-

base 10 logarithm

-
-
-

log2(x)

-

base 2 logarithm

-
-
-

power(base, exponent)

-

base raised to the power of exponent

-
-
-

round(x)

-

round to nearest integer

-
-
-

signum(x)

-

sign of the argument (-1, 0, +1)

-
-
-

sin(x)

-

sine

-
-
-

sqrt(x)

-

square root

-
-
-

tan(x)

-

tangent

-
-
-

trunc(x)

-

truncate toward zero

-
-
-
-

Conditional Functions

-
-

coalesce

-

Returns the first of its arguments that is not null. Null is returned only if all arguments are null. It is often used to substitute a default value for null values when data is retrieved for display.

-
-
-

nullif

-

Returns a null value if value1 equals value2; otherwise it returns value1. This can be used to perform the inverse operation of the coalesce expression. |

-
-
-
-

String Functions

-
-

ascii

-
-
-

bit_length

-
-
-

btrim

-
-
-

char_length

-
-
-

character_length

-
-
-

concat

-
-
-

concat_ws

-
-
-

chr

-
-
-

initcap

-
-
-

left

-
-
-

length

-
-
-

lower

-
-
-

lpad

-
-
-

ltrim

-
-
-

md5

-
-
-

octet_length

-
-
-

repeat

-
-
-

replace

-
-
-

reverse

-
- -
-

rpad

-
-
-

rtrim

-
-
-

digest

-
-
-

split_part

-
-
-

starts_with

-
-
-

strpos

-
-
-

substr

-
-
-

translate

-
-
-

trim

-
-
-

upper

-
-
-
-

Regular Expression Functions

-
-

regexp_match

-
-
-

regexp_replace

-
-
-
-

Temporal Functions

-
-

to_timestamp

-

to_timestamp() is similar to the standard SQL function. It performs conversions to type Timestamp(Nanoseconds, None), from:

-
    -

  • Timestamp strings

    -
      -

    • 1997-01-31T09:26:56.123Z # RCF3339

      • -

    • 1997-01-31T09:26:56.123-05:00 # RCF3339

      • -

    • 1997-01-31 09:26:56.123-05:00 # close to RCF3339 but with a space er than T

      • -

    • 1997-01-31T09:26:56.123 # close to RCF3339 but no timezone et specified

      • -

    • 1997-01-31 09:26:56.123 # close to RCF3339 but uses a space and timezone offset

      • -

    • 1997-01-31 09:26:56 # close to RCF3339, no fractional seconds

      • -
    -
    • -

  • An Int64 array/column, values are nanoseconds since Epoch UTC

    • -

  • Other Timestamp() columns or values

    • -
-

Note that conversions from other Timestamp and Int64 types can also be performed using CAST(.. AS Timestamp). However, the conversion functionality here is present for consistency with the other to_timestamp_xx() functions.

-
-
-

to_timestamp_millis

-

to_timestamp_millis() does conversions to type Timestamp(Milliseconds, None), from:

-
    -

  • Timestamp strings, the same as supported by the regular timestamp() function (except the output is a timestamp of Milliseconds resolution)

    -
      -

    • 1997-01-31T09:26:56.123Z # RCF3339

      • -

    • 1997-01-31T09:26:56.123-05:00 # RCF3339

      • -

    • 1997-01-31 09:26:56.123-05:00 # close to RCF3339 but with a space er than T

      • -

    • 1997-01-31T09:26:56.123 # close to RCF3339 but no timezone et specified

      • -

    • 1997-01-31 09:26:56.123 # close to RCF3339 but uses a space and timezone offset

      • -

    • 1997-01-31 09:26:56 # close to RCF3339, no fractional seconds

      • -
    -
    • -

  • An Int64 array/column, values are milliseconds since Epoch UTC

    • -

  • Other Timestamp() columns or values

    • -
-

Note that CAST(.. AS Timestamp) converts to Timestamps with Nanosecond resolution; this function is the only way to convert/cast to millisecond resolution.

-
-
-

to_timestamp_micros

-

to_timestamp_micros() does conversions to type Timestamp(Microseconds, None), from:

-
    -

  • Timestamp strings, the same as supported by the regular timestamp() function (except the output is a timestamp of microseconds resolution)

    -
      -

    • 1997-01-31T09:26:56.123Z # RCF3339

      • -

    • 1997-01-31T09:26:56.123-05:00 # RCF3339

      • -

    • 1997-01-31 09:26:56.123-05:00 # close to RCF3339 but with a space er than T

      • -

    • 1997-01-31T09:26:56.123 # close to RCF3339 but no timezone et specified

      • -

    • 1997-01-31 09:26:56.123 # close to RCF3339 but uses a space and timezone offset

      • -

    • 1997-01-31 09:26:56 # close to RCF3339, no fractional seconds

      • -
    -
    • -

  • An Int64 array/column, values are microseconds since Epoch UTC

    • -

  • Other Timestamp() columns or values

    • -
-

Note that CAST(.. AS Timestamp) converts to Timestamps with Nanosecond resolution; this function is the only way to convert/cast to microsecond resolution.

-
-
-

to_timestamp_seconds

-

to_timestamp_seconds() does conversions to type Timestamp(Seconds, None), from:

-
    -

  • Timestamp strings, the same as supported by the regular timestamp() function (except the output is a timestamp of secondseconds resolution)

    -
      -

    • 1997-01-31T09:26:56.123Z # RCF3339

      • -

    • 1997-01-31T09:26:56.123-05:00 # RCF3339

      • -

    • 1997-01-31 09:26:56.123-05:00 # close to RCF3339 but with a space er than T

      • -

    • 1997-01-31T09:26:56.123 # close to RCF3339 but no timezone et specified

      • -

    • 1997-01-31 09:26:56.123 # close to RCF3339 but uses a space and timezone offset

      • -

    • 1997-01-31 09:26:56 # close to RCF3339, no fractional seconds

      • -
    -
    • -

  • An Int64 array/column, values are seconds since Epoch UTC

    • -

  • Other Timestamp() columns or values

    • -
-

Note that CAST(.. AS Timestamp) converts to Timestamps with Nanosecond resolution; this function is the only way to convert/cast to seconds resolution.

-
-
-

extract

-

extract(field FROM source)

-
    -

  • The extract function retrieves subfields such as year or hour from date/time values. -source must be a value expression of type timestamp, Date32, or Date64. field is an identifier that selects what field to extract from the source value. -The extract function returns values of type u32.

    -
      -

    • year :extract(year FROM to_timestamp('2020-09-08T12:00:00+00:00')) -> 2020

      • -

    • month:extract(month FROM to_timestamp('2020-09-08T12:00:00+00:00')) -> 9

      • -

    • week :extract(week FROM to_timestamp('2020-09-08T12:00:00+00:00')) -> 37

      • -

    • day: extract(day FROM to_timestamp('2020-09-08T12:00:00+00:00')) -> 8

      • -

    • hour: extract(hour FROM to_timestamp('2020-09-08T12:00:00+00:00')) -> 12

      • -

    • minute: extract(minute FROM to_timestamp('2020-09-08T12:01:00+00:00')) -> 1

      • -

    • second: extract(second FROM to_timestamp('2020-09-08T12:00:03+00:00')) -> 3

      • -
    -
    • -
-
-
-

date_part

-

date_part('field', source)

-
    -

  • The date_part function is modeled on the postgres equivalent to the SQL-standard function extract. -Note that here the field parameter needs to be a string value, not a name. -The valid field names for date_part are the same as for extract.

    -
      -

    • date_part('second', to_timestamp('2020-09-08T12:00:12+00:00')) -> 12

      • -
    -
    • -
-
-
-

date_trunc

-
-
-

date_bin

-
-
-

from_unixtime

-
-
-

now

-

Returns current time as Timestamp(Nanoseconds, UTC). Returns same value for the function -wherever it appears in the statement, using a value chosen at planning time.

-
-
-
-

Other Functions

-
-

array

-
-
-

arrow_typeof

-

Returns the underlying Arrow type of the the expression:

-
❯ select arrow_typeof(4 + 4.3);
-+--------------------------------------+
-| arrowtypeof(Int64(4) + Float64(4.3)) |
-+--------------------------------------+
-| Float64                              |
-+--------------------------------------+
-
-
-
-
-

in_list

-
-
-

random

-
-
-

sha224

-
-
-

sha256

-
-
-

sha384

-
-
-

sha512

-
-
-

struct

-
-
-

to_hex

-
-
-
- - -
- - - -
- - -
-

previous

-

Aggregate Functions

-
- - -
-

next

-

Status

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/sql/select.html b/datafusion/user-guide/sql/select.html deleted file mode 100644 index 8e6f2af8172c..000000000000 --- a/datafusion/user-guide/sql/select.html +++ /dev/null @@ -1,621 +0,0 @@ - - - - - - - - - SELECT syntax — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

SELECT syntax

-

The queries in DataFusion scan data from tables and return 0 or more rows. -Please be aware that column names in queries are made lower-case, but not on the inferred schema. Accordingly, if you -want to query against a capitalized field, make sure to use double quotes. Please see this -example for clarification. -In this documentation we describe the SQL syntax in DataFusion.

-

DataFusion supports the following syntax for queries: -

-

[ WITH with_query [, …] ]
-SELECT [ ALL | DISTINCT ] select_expr [, …]
-[ FROM from_item [, …] ]
-[ JOIN join_item [, …] ]
-[ WHERE condition ]
-[ GROUP BY grouping_element [, …] ]
-[ HAVING condition]
-[ UNION [ ALL | select ]
-[ ORDER BY expression [ ASC | DESC ][, …] ]
-[ LIMIT count ]

- -
-

WITH clause

-

A with clause allows to give names for queries and reference them by name.

-
WITH x AS (SELECT a, MAX(b) AS b FROM t GROUP BY a)
-SELECT a, b FROM x;
-
-
-
-
-

SELECT clause

-

Example:

-
SELECT a, b, a + b FROM table
-
-
-

The DISTINCT quantifier can be added to make the query return all distinct rows. -By default ALL will be used, which returns all the rows.

-
SELECT DISTINCT person, age FROM employees
-
-
-
-
-

FROM clause

-

Example:

-
SELECT t.a FROM table AS t
-
-
-
-
-

WHERE clause

-

Example:

-
SELECT a FROM table WHERE a > 10
-
-
-
-
-

JOIN clause

-

DataFusion supports INNER JOIN, LEFT OUTER JOIN, RIGHT OUTER JOIN, FULL OUTER JOIN, and CROSS JOIN.

-

The following examples are based on this table:

-
select * from x;
-+----------+----------+
-| column_1 | column_2 |
-+----------+----------+
-| 1        | 2        |
-+----------+----------+
-
-
-
-

INNER JOIN

-

The keywords JOIN or INNER JOIN define a join that only shows rows where there is a match in both tables.

-
❯ select * from x inner join x y ON x.column_1 = y.column_1;
-+----------+----------+----------+----------+
-| column_1 | column_2 | column_1 | column_2 |
-+----------+----------+----------+----------+
-| 1        | 2        | 1        | 2        |
-+----------+----------+----------+----------+
-
-
-
-
-

LEFT OUTER JOIN

-

The keywords LEFT JOIN or LEFT OUTER JOIN define a join that includes all rows from the left table even if there -is not a match in the right table. When there is no match, null values are produced for the right side of the join.

-
❯ select * from x left join x y ON x.column_1 = y.column_2;
-+----------+----------+----------+----------+
-| column_1 | column_2 | column_1 | column_2 |
-+----------+----------+----------+----------+
-| 1        | 2        |          |          |
-+----------+----------+----------+----------+
-
-
-
-
-

RIGHT OUTER JOIN

-

The keywords RIGHT JOIN or RIGHT OUTER JOIN define a join that includes all rows from the right table even if there -is not a match in the left table. When there is no match, null values are produced for the left side of the join.

-
❯ select * from x right join x y ON x.column_1 = y.column_2;
-+----------+----------+----------+----------+
-| column_1 | column_2 | column_1 | column_2 |
-+----------+----------+----------+----------+
-|          |          | 1        | 2        |
-+----------+----------+----------+----------+
-
-
-
-
-

FULL OUTER JOIN

-

The keywords FULL JOIN or FULL OUTER JOIN define a join that is effectively a union of a LEFT OUTER JOIN and -RIGHT OUTER JOIN. It will show all rows from the left and right side of the join and will produce null values on -either side of the join where there is not a match.

-
❯ select * from x full outer join x y ON x.column_1 = y.column_2;
-+----------+----------+----------+----------+
-| column_1 | column_2 | column_1 | column_2 |
-+----------+----------+----------+----------+
-| 1        | 2        |          |          |
-|          |          | 1        | 2        |
-+----------+----------+----------+----------+
-
-
-
-
-

CROSS JOIN

-

A cross join produces a cartesian product that matches every row in the left side of the join with every row in the -right side of the join.

-
❯ select * from x cross join x y;
-+----------+----------+----------+----------+
-| column_1 | column_2 | column_1 | column_2 |
-+----------+----------+----------+----------+
-| 1        | 2        | 1        | 2        |
-+----------+----------+----------+----------+
-
-
-
-
-
-

GROUP BY clause

-

Example:

-
SELECT a, b, MAX(c) FROM table GROUP BY a, b
-
-
-
-
-

HAVING clause

-

Example:

-
SELECT a, b, MAX(c) FROM table GROUP BY a, b HAVING MAX(c) > 10
-
-
-
-
-

UNION clause

-

Example:

-
SELECT
-    a,
-    b,
-    c
-FROM table1
-UNION ALL
-SELECT
-    a,
-    b,
-    c
-FROM table2
-
-
-
-
-

ORDER BY clause

-

Orders the results by the referenced expression. By default it uses ascending order (ASC). -This order can be changed to descending by adding DESC after the order-by expressions.

-

Examples:

-
SELECT age, person FROM table ORDER BY age;
-SELECT age, person FROM table ORDER BY age DESC;
-SELECT age, person FROM table ORDER BY age, person DESC;
-
-
-
-
-

LIMIT clause

-

Limits the number of rows to be a maximum of count rows. count should be a non-negative integer.

-

Example:

-
SELECT age, person FROM table
-LIMIT 10
-
-
-
-
- - -
- - - -
- - -
-

previous

-

Data Types

-
- - -
-

next

-

Subqueries

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/sql/sql_status.html b/datafusion/user-guide/sql/sql_status.html deleted file mode 100644 index 832014d5ba36..000000000000 --- a/datafusion/user-guide/sql/sql_status.html +++ /dev/null @@ -1,528 +0,0 @@ - - - - - - - - - Status — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Status

-
-

General

-
    -

  • SQL Parser

    • -

  • SQL Query Planner

    • -

  • Query Optimizer

    • -

  • Constant folding

    • -

  • Join Reordering

    • -

  • Limit Pushdown

    • -

  • Projection push down

    • -

  • Predicate push down

    • -

  • Type coercion

    • -

  • Parallel query execution

    • -
-
-
-

SQL Support

-
    -

  • Projection

    • -

  • Filter (WHERE)

    • -

  • Filter post-aggregate (HAVING)

    • -

  • Limit

    • -

  • Aggregate

    • -

  • Common math functions

    • -

  • cast

    • -

  • try_cast

    • -

  • VALUES lists

    • -

  • Postgres compatible String functions

    -
      -

    • ascii

      • -

    • bit_length

      • -

    • btrim

      • -

    • char_length

      • -

    • character_length

      • -

    • chr

      • -

    • concat

      • -

    • concat_ws

      • -

    • initcap

      • -

    • left

      • -

    • length

      • -

    • lpad

      • -

    • ltrim

      • -

    • octet_length

      • -

    • regexp_replace

      • -

    • repeat

      • -

    • replace

      • -

    • reverse

      • -

    • right

      • -

    • rpad

      • -

    • rtrim

      • -

    • split_part

      • -

    • starts_with

      • -

    • strpos

      • -

    • substr

      • -

    • to_hex

      • -

    • translate

      • -

    • trim

      • -
    -
    • -

  • Conditional functions

    -
      -

    • nullif

      • -

    • case

      • -

    • coalesce

      • -
    -
    • -

  • Approximation functions

    -
      -

    • approx_distinct

      • -

    • approx_median

      • -

    • approx_percentile_cont

      • -

    • approx_percentile_cont_with_weight

      • -
    -
    • -

  • Common date/time functions

    - -
    • -

  • nested functions

    -
      -

    • Array of columns

      • -
    -
    • -

  • Schema Queries

    -
      -

    • SHOW TABLES

      • -

    • SHOW COLUMNS FROM <table/view>

      • -

    • SHOW CREATE TABLE

      • -

    • information_schema.{tables, columns, views}

      • -

    • information_schema other views

      • -
    -
    • -

  • Sorting

    • -

  • Nested types

    • -

  • Lists

    • -

  • Subqueries

    • -

  • Common table expressions

    • -

  • Set Operations

    -
      -

    • UNION ALL

      • -

    • UNION

      • -

    • INTERSECT

      • -

    • INTERSECT ALL

      • -

    • EXCEPT

      • -

    • EXCEPT ALL

      • -
    -
    • -

  • Joins

    -
      -

    • INNER JOIN

      • -

    • LEFT JOIN

      • -

    • RIGHT JOIN

      • -

    • FULL JOIN

      • -

    • CROSS JOIN

      • -
    -
    • -

  • Window

    -
      -

    • Empty window

      • -

    • Common window functions

      • -

    • Window with PARTITION BY clause

      • -

    • Window with ORDER BY clause

      • -

    • Window with FILTER clause

      • -

    • Window with custom WINDOW FRAME

      • -

    • UDF and UDAF for window functions

      • -
    -
    • -
-
-
-

Data Sources

-
    -

  • CSV

    • -

  • Parquet primitive types

    • -

  • Parquet nested types

    • -

  • JSON

    • -

  • Avro

    • -
-
-
- - -
- - - -
- - -
-

previous

-

Scalar Functions

-
- - -
-

next

-

Configuration Settings

-
- - -
- -
- - -
-
- - -
-
- -
-

- © Copyright 2022, Apache Software Foundation.
-

-
- -
-

-Created using Sphinx 5.1.1.
-

-
- -
-
- - \ No newline at end of file diff --git a/datafusion/user-guide/sql/subqueries.html b/datafusion/user-guide/sql/subqueries.html deleted file mode 100644 index 357cc8708fcc..000000000000 --- a/datafusion/user-guide/sql/subqueries.html +++ /dev/null @@ -1,457 +0,0 @@ - - - - - - - - - Subqueries — Arrow DataFusion documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - - - -
- - -
- - -
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- - -
- - Edit this page - -
- -
- - -
- - - - - - -
- -
- - -
-

Subqueries

-

DataFusion supports EXISTS, NOT EXISTS, IN, NOT IN and Scalar Subqueries.

-

The examples below are based on the following table.

-
❯ select * from x;
-+----------+----------+
-| column_1 | column_2 |
-+----------+----------+
-| 1        | 2        |
-+----------+----------+
-
-
-
-

EXISTS

-

The EXISTS syntax can be used to find all rows in a relation where a correlated subquery produces one or more matches -for that row. Only correlated subqueries are supported.

-
❯ select * from x y where exists (select * from x where x.column_1 = y.column_1);
-+----------+----------+
-| column_1 | column_2 |
-+----------+----------+
-| 1        | 2        |
-+----------+----------+
-1 row in set.
-
-
-
-
-

NOT EXISTS

-

The NOT EXISTS syntax can be used to find all rows in a relation where a correlated subquery produces zero matches -for that row. Only correlated subqueries are supported.

-
❯ select * from x y where not exists (select * from x where x.column_1 = y.column_1);
-0 rows in set.
-
-
-
-
-

IN

-

The IN syntax can be used to find all rows in a relation where a given expression’s value can be found in the -results of a correlated subquery.

-
❯ select * from x where column_1 in (select column_1 from x);
-+----------+----------+
-| column_1 | column_2 |
-+----------+----------+
-| 1        | 2        |
-+----------+----------+
-1 row in set.
-
-
-
-
-

NOT IN

-

The NOT IN syntax can be used to find all rows in a relation where a given expression’s value can not be found in the -results of a correlated subquery.

-
❯ select * from x where column_1 not in (select column_1 from x);
-0 rows in set.
-
-
-
-
-

Scalar Subquery

-

A scalar subquery can be used to produce a single value that can be used in many different contexts in a query. Here -is an example of a filter using a scalar subquery. Only correlated subqueries are supported.

-
❯ select * from x y where column_1 < (select sum(column_2) from x where x.column_1 = y.column_1);
-+----------+----------+
-| column_1 | column_2 |
-+----------+----------+
-| 1        | 2        |
-+----------+----------+
-1 row in set.
-
-
-
-
- - -
- - - -
- - -
-

previous

-

SELECT syntax

-
- - -
-

next

-

DDL

-
- - -
- -
- - -
-
- - - - - \ No newline at end of file