:root{--max:1150px;--dark-bg:#16181c;--dark-outer:#000;--dark-fg:#e4e7eb;--dark-muted:#a3adb0;--dark-wordmark:#a3adb0;--dark-line:color-mix(in srgb, #576a70 75%, var(--dark-bg));--dark-accent:#d37a1b;--dark-accent-fg:#303234;--dark-link:#d37a1b;--dark-panel:color-mix(in srgb, #c7d9d6 14%, var(--dark-bg));--dark-warn-bg:#3a2426;--dark-code-bg:#262b31;--dark-ide:#b99aef;--dark-vscode:#6bb5f5;--dark-drop-shadow-colour:#000;--dark-icon-black:#f0f0f0;--dark-icon-blue:#58b6ff;--dark-icon-red:#f15262;--dark-icon-yellow:#ffdd96;--dark-icon-green:#94f591;--dark-icon-purple:#c59cf0;--dark-alert:#ff5c5c;--dark-py-o:#7da7ff;--dark-py-k:#ff8a80;--dark-py-s:#7fc4f0;--dark-py-n:#4fc3f7;--dark-py-c:#7fc87f;--dark-py-x:#9aa0a6;--bg:#fbfaf9;--outer:#92a2a6;--fg:#565b61;--muted:#576a70;--wordmark:#576a70;--line:#c4cbcd;--accent:#f9981e;--accent-fg:#404244;--link:#a85a00;--panel:#eef1f3;--warn-bg:#fbeaea;--code-bg:#eef1f3;--ide:#6c3fb5;--vscode:#1a73c4;--drop-shadow-colour:#aaa;--icon-black:#202020;--icon-blue:#006cbf;--icon-red:#c50f1f;--icon-yellow:#b27d00;--icon-green:#11910d;--icon-purple:#68217a;--alert:#e60000;--py-o:#0000c0;--py-k:#c00000;--py-s:#004080;--py-n:#0080c0;--py-c:green;--py-x:gray}@media (prefers-color-scheme:dark){:root:not([data-theme=light]){--bg:var(--dark-bg);--outer:var(--dark-outer);--fg:var(--dark-fg);--muted:var(--dark-muted);--wordmark:var(--dark-wordmark);--line:var(--dark-line);--accent:var(--dark-accent);--accent-fg:var(--dark-accent-fg);--link:var(--dark-link);--panel:var(--dark-panel);--warn-bg:var(--dark-warn-bg);--code-bg:var(--dark-code-bg);--ide:var(--dark-ide);--vscode:var(--dark-vscode);--drop-shadow-colour:var(--dark-drop-shadow-colour);--icon-black:var(--dark-icon-black);--icon-blue:var(--dark-icon-blue);--icon-red:var(--dark-icon-red);--icon-yellow:var(--dark-icon-yellow);--icon-green:var(--dark-icon-green);--icon-purple:var(--dark-icon-purple);--alert:var(--dark-alert);--py-o:var(--dark-py-o);--py-k:var(--dark-py-k);--py-s:var(--dark-py-s);--py-n:var(--dark-py-n);--py-c:var(--dark-py-c);--py-x:var(--dark-py-x);color-scheme:dark}}:root[data-theme=dark]{--bg:var(--dark-bg);--outer:var(--dark-outer);--fg:var(--dark-fg);--muted:var(--dark-muted);--wordmark:var(--dark-wordmark);--line:var(--dark-line);--accent:var(--dark-accent);--accent-fg:var(--dark-accent-fg);--link:var(--dark-link);--panel:var(--dark-panel);--warn-bg:var(--dark-warn-bg);--code-bg:var(--dark-code-bg);--ide:var(--dark-ide);--vscode:var(--dark-vscode);--drop-shadow-colour:var(--dark-drop-shadow-colour);--icon-black:var(--dark-icon-black);--icon-blue:var(--dark-icon-blue);--icon-red:var(--dark-icon-red);--icon-yellow:var(--dark-icon-yellow);--icon-green:var(--dark-icon-green);--icon-purple:var(--dark-icon-purple);--alert:var(--dark-alert);--py-o:var(--dark-py-o);--py-k:var(--dark-py-k);--py-s:var(--dark-py-s);--py-n:var(--dark-py-n);--py-c:var(--dark-py-c);--py-x:var(--dark-py-x);color-scheme:dark}:root[data-theme=light]{color-scheme:light}*{box-sizing:border-box}html{scrollbar-gutter:stable}body{background:var(--outer);color:var(--fg);margin:0;font:1rem/1.6 system-ui,-apple-system,Segoe UI,sans-serif}a{color:var(--link)}img{max-width:100%;height:auto}img.icon,svg.icon,kbd img,kbd svg{vertical-align:-.25em;width:auto;max-width:none;height:1.2em}.icon-fill-black{fill:var(--icon-black)}.icon-stroke-black{stroke:var(--icon-black)}.icon-fill-blue{fill:var(--icon-blue)}.icon-stroke-blue{stroke:var(--icon-blue)}.icon-fill-red{fill:var(--icon-red)}.icon-stroke-red{stroke:var(--icon-red)}.icon-fill-yellow{fill:var(--icon-yellow)}.icon-stroke-yellow{stroke:var(--icon-yellow)}.icon-fill-green{fill:var(--icon-green)}.icon-stroke-green{stroke:var(--icon-green)}.icon-fill-purple{fill:var(--icon-purple)}.icon-stroke-purple{stroke:var(--icon-purple)}code,kbd,.query{background:var(--code-bg);border-radius:4px;padding:.1em .35em;font-family:ui-monospace,Consolas,monospace;font-size:.92em}pre{background:var(--code-bg);border-radius:6px;padding:1em;font-family:ui-monospace,Consolas,monospace;font-size:.92em;overflow-x:auto}pre code{background:0 0;padding:0}pre.command-line{clear:both;color:#ccc;white-space:pre-wrap;background-color:#000;margin-left:1em;padding:.5em;font-weight:700}pre.command-line .filename{color:#fff}pre.command-line .hit{color:#ff0}img.float-right{float:right;margin:0 0 .5rem 1rem}.inline-watch-value{color:#333;background-color:#ffffb8;border:1px solid #e0c000;border-radius:.6em;padding:0 .6em;font-family:Calibri,Helvetica Neue,Arial,Helvetica,sans-serif;font-size:90%}.search-box-sample{border:1px solid var(--muted);padding:3px 20px 3px 4px;font-family:sans-serif;font-size:90%}.page{max-width:var(--max);background:var(--bg);border-radius:10px;margin:12px auto;padding:1rem}.wrap{padding:0 1.25rem}.skip{position:absolute;left:-999px}.skip:focus{background:var(--bg);z-index:10;padding:.5rem;top:1rem;left:1rem}.site-header{border-bottom:1px solid var(--line);margin:0 -1rem;padding:0 1rem;container-type:inline-size}.header-row{grid-template-columns:1fr;grid-template-areas:"logo""tools""nav";gap:0;padding-bottom:.6rem;display:grid}.header-row .logo{grid-area:logo;justify-self:start}.header-row .header-tools{grid-area:tools}.header-row nav{grid-area:nav}@container (width>=38.75rem){.header-row{grid-template-columns:1fr auto;grid-template-areas:"logo tools""nav nav";align-items:center}.header-row .header-tools{justify-self:end}}@container (width>=66.25rem){.header-row{grid-template-areas:".tools""logo nav";align-items:last baseline}.header-row nav{justify-self:end}}.logo{color:var(--wordmark);align-items:baseline;gap:.6rem;font-size:1.75rem;line-height:1;display:flex}.logo img{display:block}.header-right{display:contents}.header-tools{align-items:center;gap:.6rem;display:flex}html:root{--pf-mark:var(--fg);--pf-background:var(--bg);--pf-text:var(--fg);--pf-text-secondary:var(--muted);--pf-text-muted:var(--muted);--pf-border:var(--line);--pf-border-focus:var(--accent);--pf-hover:var(--panel);--pf-font:inherit}.search{--pf-searchbox-max-width:18rem;--pf-input-height:1.9rem;--pf-input-font-size:.85rem;width:18rem;padding-right:.4rem}.search-lazy{--pf-icon-search:url("data:image/svg+xml,%3Csvg viewBox='0 0 16 16' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M11.7 10.3a6 6 0 1 0-1.4 1.4l3.5 3.5 1.4-1.4zM6.5 10.5a4 4 0 1 1 0-8 4 4 0 0 1 0 8z'/%3E%3C/svg%3E");width:100%;max-width:var(--pf-searchbox-max-width)}.search-lazy .pf-searchbox-input-wrapper{position:relative}.search-lazy .pf-searchbox-input-wrapper:before{content:"";z-index:1;width:14px;height:14px;top:calc((var(--pf-input-height) - 14px) / 2);background-color:var(--pf-text-muted);-webkit-mask-image:var(--pf-icon-search);mask-image:var(--pf-icon-search);pointer-events:none;position:absolute;inset-inline-start:10px;-webkit-mask-size:100%;mask-size:100%}.search-lazy .pf-searchbox-input{box-sizing:border-box;width:100%;height:var(--pf-input-height);background-color:var(--pf-background);border:1px solid var(--pf-border);font-family:inherit;font-size:var(--pf-input-font-size);color:var(--pf-text);border-radius:6px;padding:0 72px 0 32px}.search-lazy .pf-searchbox-input::placeholder{color:var(--pf-text-muted)}.search-lazy .pf-searchbox-input:focus{border-color:var(--pf-border-focus);outline:none;padding-inline-end:12px}.search-lazy .pf-trigger-shortcut{inset-inline-end:12px;pointer-events:none;gap:2px;display:inline-flex;position:absolute;top:50%;transform:translateY(-50%)}.search-lazy .pf-searchbox-input:focus~.pf-trigger-shortcut{display:none}.search-lazy .pf-trigger-key{background:var(--pf-hover);border:1px solid var(--pf-border);min-width:20px;height:18px;color:var(--pf-text-secondary);border-radius:4px;justify-content:center;align-items:center;padding:0 4px;font-size:11px;font-weight:500;display:inline-flex}.search .pf-searchbox-dropdown{width:min(40rem,90vw)!important;left:auto!important;right:0!important}.topnav{flex-wrap:wrap;margin:0;padding:0;list-style:none;display:flex}.topnav a,.manual-nav a{border-left:1px solid var(--line);color:var(--fg);padding:.15rem .6rem;display:block}a{text-decoration:none}a:hover{text-decoration:underline}.topnav a[aria-current],.manual-nav a[aria-current]{border-left:3px solid var(--accent);padding-left:calc(.6rem - 2px);font-weight:700}.manual-nav{float:right;width:13rem;margin:4px 0 2rem 2rem;font-size:.92rem}.manual-nav ul{margin:0;padding:0;list-style:none}@media (width<=40rem){.manual-nav{float:none;width:auto;margin:0 0 1rem}}.page-heading{flex-wrap:wrap;justify-content:space-between;align-items:baseline;gap:.25rem 1.5rem;display:flex}.edition-switch{visibility:hidden;color:var(--muted);align-items:center;gap:.75rem;margin-left:auto;font-size:.9rem;display:flex}.seg{border:1px solid var(--line);border-radius:6px;display:inline-flex;overflow:hidden}.seg button{white-space:nowrap;font:inherit;color:var(--fg);cursor:pointer;background:0 0;border:0;padding:.2rem .8rem}.seg.small button{padding:.05rem .45rem;font-size:.8rem;line-height:1.5}.seg button[aria-pressed=true]{background:var(--accent);color:var(--accent-fg)}.notices{padding-top:1.5rem}.notices+.layout{padding-top:0}.layout{padding-top:1rem;padding-bottom:3rem;display:block}@media (width>=52rem){.layout.has-sidebar{grid-template-columns:minmax(0,1fr) 15rem;align-items:baseline;gap:2rem;display:grid}}@media (width<=51.99rem){.page{padding:0}.site-header{margin:0}.sidebar{border-top:1px solid var(--line);margin-top:2rem;padding-top:1rem}}.sidebar,section.inline-panel{border:1px solid var(--line);border-radius:10px;padding:1rem}section.inline-panel{display:flow-root}.sidebar h3{margin:1.5rem 0 .5rem;font-size:1rem}.sidebar h3:first-child{margin-top:0}.sidebar ul{padding-left:1.1rem}.site-footer .theme-switch{vertical-align:middle;margin:0 0 0 .25rem}.small{color:var(--muted);margin:.25rem 0 1rem;font-size:.9rem}blockquote{border-left:3px solid var(--accent);margin:0;padding-left:1rem}blockquote footer{color:var(--muted);font-size:.9rem}.testimonials blockquote{border-left:0;min-height:4.5rem;margin:0 0 2.5rem;padding-left:5rem;line-height:1.5;position:relative}.testimonials blockquote:before{content:"“";content:"“" / "";color:var(--accent);font:700 6rem/1 Georgia,Times New Roman,serif;position:absolute;top:-.15rem;left:0}.testimonials blockquote p{margin:0 0 1em}.testimonials blockquote>p:last-child{text-align:right;margin-bottom:0}@media (width<=40rem){.testimonials blockquote{padding-left:3rem}.testimonials blockquote:before{font-size:4rem}}.btn{text-align:center;border:1px solid var(--accent);border-radius:8px;padding:.25rem 1rem;font-weight:600;display:block}.btn.primary{background:var(--accent);color:var(--accent-fg)}.btn h2{margin:0}.btn.centered{width:13rem;margin:1.5rem auto}.banner{background:var(--warn-bg);border:1px solid var(--line);border-radius:10px;margin-bottom:1.5rem;padding:.5rem 1.25rem}.banner h2{margin:.5rem 0 0;font-size:1.1rem}h1,h2,h3,h4,h5,h6{margin:.5em 0 0;font-weight:500}p{margin:.3em 0 1em}h1{margin-top:6px;font-size:1.6rem;font-weight:500;line-height:1.2}main h1,.sidebar h3{margin:0 0 8px}.hero-area{padding-top:1.5rem}.wide-area{padding-bottom:3rem}.layout:has(+.wide-area){padding-bottom:1.5rem}.notices+.hero-area{padding-top:0}.hero .lead{font-size:1.15rem}.hero img,img.shadowed{filter:drop-shadow(2px 2px 10px var(--drop-shadow-colour));margin:.75rem 0 .25em}.features{grid-template-columns:repeat(auto-fit,minmax(16rem,1fr));gap:1.5rem;margin:2rem 0;display:grid}.feature{background:var(--panel);border-radius:10px;padding:0 1.25rem}.feature img{border-radius:4px}.feature h3{margin:.75rem 0 .5rem}.pager{clear:both;border-top:1px solid var(--line);justify-content:space-between;margin-top:2rem;padding-top:1rem;display:flex}table{border-collapse:collapse}th,td{border:1px solid var(--line);text-align:left;vertical-align:top;padding:.4rem .7rem}.for-ide,.for-code{border-left:4px solid;margin:1rem 0;padding:.1rem 0 .1rem 1rem}.for-ide{border-color:var(--ide)}.for-code{border-color:var(--vscode)}.for-ide:before,.for-code:before{text-transform:uppercase;letter-spacing:.05em;font-size:.78rem;font-weight:700;display:block}.for-ide:before{content:"Visual Studio";color:var(--ide)}.for-code:before{content:"VS Code";color:var(--vscode)}[data-platform=ide] .for-code,[data-platform=code] .for-ide{display:none}[data-platform=ide] .for-ide,[data-platform=code] .for-code{border-left:0;padding-left:0}[data-platform=ide] .for-ide:before,[data-platform=code] .for-code:before,.for-code{display:none}.site-footer{border-top:1px solid var(--line);color:var(--muted);padding:1.5rem 0;font-size:.9rem}.themed-dark,:root[data-theme=dark] .themed-light{display:none}:root[data-theme=dark] .themed-dark{display:revert}@media (prefers-color-scheme:dark){:root:not([data-theme=light]) .themed-light{display:none}:root:not([data-theme=light]) .themed-dark{display:revert}}.verbosity-slider{-webkit-appearance:none;appearance:none;vertical-align:middle;cursor:pointer;background:0 0;width:54px;height:19px;margin:0 .1em;padding:0}.verbosity-slider::-webkit-slider-runnable-track{background:var(--line);border:1px solid var(--muted);border-radius:1px;height:3px}.verbosity-slider::-moz-range-track{background:var(--line);border:1px solid var(--muted);border-radius:1px;height:1px}.verbosity-slider::-webkit-slider-thumb{-webkit-appearance:none;background:var(--icon-blue);clip-path:polygon(0 0,100% 0,100% 60%,50% 100%,0 60%);border:0;width:11px;height:17px;margin-top:-8px}.verbosity-slider::-moz-range-thumb{background:var(--icon-blue);clip-path:polygon(0 0,100% 0,100% 60%,50% 100%,0 60%);border:0;border-radius:0;width:11px;height:17px}.verbosity-slider:focus-visible{outline:2px solid var(--accent);outline-offset:2px}.translations{float:right;width:16rem;color:var(--muted);margin:0 0 1rem 2rem;font-size:.9rem}@media (width<=700px){.translations{display:none}}pre.pycon{color:var(--fg)}pre.pycon i{font-style:normal}.py-o{color:var(--py-o)}.py-k{color:var(--py-k)}.py-s{color:var(--py-s)}.py-n{color:var(--py-n)}.py-c{color:var(--py-c)}.py-x{color:var(--py-x)}.alert{color:var(--alert);border:2px solid var(--alert);border-radius:6px;padding:.75rem 1rem;font-size:1.2rem;font-weight:700}.vs-logo[data-astro-cid-zfqhvip4]{vertical-align:-4px;margin-right:2px}