\n * @version 0.0.1\n * @license MIT\n */\n\n'use strict';\n\n/** Generate a terminal widget. */\nclass Termynal {\n /**\n * Construct the widget's settings.\n * @param {(string|Node)=} container - Query selector or container element.\n * @param {Object=} options - Custom settings.\n * @param {string} options.prefix - Prefix to use for data attributes.\n * @param {number} options.startDelay - Delay before animation, in ms.\n * @param {number} options.typeDelay - Delay between each typed character, in ms.\n * @param {number} options.lineDelay - Delay between each line, in ms.\n * @param {number} options.progressLength - Number of characters displayed as progress bar.\n * @param {string} options.progressChar β Character to use for progress bar, defaults to β.\n * @param {number} options.progressPercent - Max percent of progress.\n * @param {string} options.cursor β Character to use for cursor, defaults to β.\n * @param {Object[]} lineData - Dynamically loaded line data objects.\n * @param {boolean} options.noInit - Don't initialise the animation.\n */\n constructor(container = '#termynal', options = {}) {\n this.container = (typeof container === 'string') ? document.querySelector(container) : container;\n this.pfx = `data-${options.prefix || 'ty'}`;\n this.originalStartDelay = this.startDelay = options.startDelay\n || parseFloat(this.container.getAttribute(`${this.pfx}-startDelay`)) || 600;\n this.originalTypeDelay = this.typeDelay = options.typeDelay\n || parseFloat(this.container.getAttribute(`${this.pfx}-typeDelay`)) || 90;\n this.originalLineDelay = this.lineDelay = options.lineDelay\n || parseFloat(this.container.getAttribute(`${this.pfx}-lineDelay`)) || 1500;\n this.progressLength = options.progressLength\n || parseFloat(this.container.getAttribute(`${this.pfx}-progressLength`)) || 40;\n this.progressChar = options.progressChar\n || this.container.getAttribute(`${this.pfx}-progressChar`) || 'β';\n this.progressPercent = options.progressPercent\n || parseFloat(this.container.getAttribute(`${this.pfx}-progressPercent`)) || 100;\n this.cursor = options.cursor\n || this.container.getAttribute(`${this.pfx}-cursor`) || 'β';\n this.lineData = this.lineDataToElements(options.lineData || []);\n this.loadLines()\n if (!options.noInit) this.init()\n }\n\n loadLines() {\n // Load all the lines and create the container so that the size is fixed\n // Otherwise it would be changing and the user viewport would be constantly\n // moving as she/he scrolls\n const finish = this.generateFinish()\n finish.style.visibility = 'hidden'\n this.container.appendChild(finish)\n // Appends dynamically loaded lines to existing line elements.\n this.lines = [...this.container.querySelectorAll(`[${this.pfx}]`)].concat(this.lineData);\n for (let line of this.lines) {\n line.style.visibility = 'hidden'\n this.container.appendChild(line)\n }\n const restart = this.generateRestart()\n restart.style.visibility = 'hidden'\n this.container.appendChild(restart)\n this.container.setAttribute('data-termynal', '');\n }\n\n /**\n * Initialise the widget, get lines, clear container and start animation.\n */\n init() {\n /**\n * Calculates width and height of Termynal container.\n * If container is empty and lines are dynamically loaded, defaults to browser `auto` or CSS.\n */\n const containerStyle = getComputedStyle(this.container);\n this.container.style.width = containerStyle.width !== '0px' ?\n containerStyle.width : undefined;\n this.container.style.minHeight = containerStyle.height !== '0px' ?\n containerStyle.height : undefined;\n\n this.container.setAttribute('data-termynal', '');\n this.container.innerHTML = '';\n for (let line of this.lines) {\n line.style.visibility = 'visible'\n }\n this.start();\n }\n\n /**\n * Start the animation and rener the lines depending on their data attributes.\n */\n async start() {\n this.addFinish()\n await this._wait(this.startDelay);\n\n for (let line of this.lines) {\n const type = line.getAttribute(this.pfx);\n const delay = line.getAttribute(`${this.pfx}-delay`) || this.lineDelay;\n\n if (type == 'input') {\n line.setAttribute(`${this.pfx}-cursor`, this.cursor);\n await this.type(line);\n await this._wait(delay);\n }\n\n else if (type == 'progress') {\n await this.progress(line);\n await this._wait(delay);\n }\n\n else {\n this.container.appendChild(line);\n await this._wait(delay);\n }\n\n line.removeAttribute(`${this.pfx}-cursor`);\n }\n this.addRestart()\n this.finishElement.style.visibility = 'hidden'\n this.lineDelay = this.originalLineDelay\n this.typeDelay = this.originalTypeDelay\n this.startDelay = this.originalStartDelay\n }\n\n generateRestart() {\n const restart = document.createElement('a')\n restart.onclick = (e) => {\n e.preventDefault()\n this.container.innerHTML = ''\n this.init()\n }\n restart.href = '#'\n restart.setAttribute('data-terminal-control', '')\n restart.innerHTML = \"restart β»\"\n return restart\n }\n\n generateFinish() {\n const finish = document.createElement('a')\n finish.onclick = (e) => {\n e.preventDefault()\n this.lineDelay = 0\n this.typeDelay = 0\n this.startDelay = 0\n }\n finish.href = '#'\n finish.setAttribute('data-terminal-control', '')\n finish.innerHTML = \"fast β\"\n this.finishElement = finish\n return finish\n }\n\n addRestart() {\n const restart = this.generateRestart()\n this.container.appendChild(restart)\n }\n\n addFinish() {\n const finish = this.generateFinish()\n this.container.appendChild(finish)\n }\n\n /**\n * Animate a typed line.\n * @param {Node} line - The line element to render.\n */\n async type(line) {\n const chars = [...line.textContent];\n line.textContent = '';\n this.container.appendChild(line);\n\n for (let char of chars) {\n const delay = line.getAttribute(`${this.pfx}-typeDelay`) || this.typeDelay;\n await this._wait(delay);\n line.textContent += char;\n }\n }\n\n /**\n * Animate a progress bar.\n * @param {Node} line - The line element to render.\n */\n async progress(line) {\n const progressLength = line.getAttribute(`${this.pfx}-progressLength`)\n || this.progressLength;\n const progressChar = line.getAttribute(`${this.pfx}-progressChar`)\n || this.progressChar;\n const chars = progressChar.repeat(progressLength);\n const progressPercent = line.getAttribute(`${this.pfx}-progressPercent`)\n || this.progressPercent;\n line.textContent = '';\n this.container.appendChild(line);\n\n for (let i = 1; i < chars.length + 1; i++) {\n await this._wait(this.typeDelay);\n const percent = Math.round(i / chars.length * 100);\n line.textContent = `${chars.slice(0, i)} ${percent}%`;\n if (percent > progressPercent) {\n break;\n }\n }\n }\n\n /**\n * Helper function for animation delays, called with `await`.\n * @param {number} time - Timeout, in ms.\n */\n _wait(time) {\n return new Promise(resolve => setTimeout(resolve, time));\n }\n\n /**\n * Converts line data objects into line elements.\n *\n * @param {Object[]} lineData - Dynamically loaded lines.\n * @param {Object} line - Line data object.\n * @returns {Element[]} - Array of line elements.\n */\n lineDataToElements(lineData) {\n return lineData.map(line => {\n let div = document.createElement('div');\n div.innerHTML = `${line.value || ''} `;\n\n return div.firstElementChild;\n });\n }\n\n /**\n * Helper function for generating attributes string.\n *\n * @param {Object} line - Line data object.\n * @returns {string} - String of attributes.\n */\n _attributes(line) {\n let attrs = '';\n for (let prop in line) {\n // Custom add class\n if (prop === 'class') {\n attrs += ` class=${line[prop]} `\n continue\n }\n if (prop === 'type') {\n attrs += `${this.pfx}=\"${line[prop]}\" `\n } else if (prop !== 'value') {\n attrs += `${this.pfx}-${prop}=\"${line[prop]}\" `\n }\n }\n\n return attrs;\n }\n}\n\n/**\n* HTML API: If current script has container(s) specified, initialise Termynal.\n*/\nif (document.currentScript.hasAttribute('data-termynal-container')) {\n const containers = document.currentScript.getAttribute('data-termynal-container');\n containers.split('|')\n .forEach(container => new Termynal(container))\n}\n"
},
{
"path": "docs/assets/css-js/general/css/progressbar.css",
"content": "/*\n * Source: https://facelessuser.github.io/pymdown-extensions/extensions/progressbar/\n *\n * Note: Look under \"CSS Setup\".\n *\n */\n\n.progress-label {\n position: absolute;\n text-align: center;\n font-weight: 700;\n width: 100%;\n margin: 0;\n line-height: 1.2rem;\n white-space: nowrap;\n overflow: hidden;\n}\n\n.progress-bar {\n height: 1.2rem;\n float: left;\n background-color: #2979ff;\n}\n\n.progress {\n display: block;\n width: 100%;\n margin: 0.5rem 0;\n height: 1.2rem;\n background-color: #eeeeee;\n position: relative;\n}\n\n.progress.thin {\n margin-top: 0.9rem;\n height: 0.4rem;\n}\n\n.progress.thin .progress-label {\n margin-top: -0.4rem;\n}\n\n.progress.thin .progress-bar {\n height: 0.4rem;\n}\n\n/* ColorPalette Source: https://colorbrewer2.org/#type=diverging&scheme=RdYlGn&n=11 */\n\n.progress-0plus .progress-bar {\n background-color: #a50026;\n}\n\n.progress-10plus .progress-bar {\n background-color: #d73027;\n}\n\n.progress-20plus .progress-bar {\n background-color: #f46d43;\n}\n\n.progress-30plus .progress-bar {\n background-color: #fdae61;\n}\n\n.progress-40plus .progress-bar {\n background-color: #fee08b;\n}\n\n.progress-50plus .progress-bar {\n background-color: #ffffbf;\n}\n\n.progress-60plus .progress-bar {\n background-color: #d9ef8b;\n}\n\n.progress-70plus .progress-bar {\n background-color: #a6d96a;\n}\n\n.progress-80plus .progress-bar {\n background-color: #66bd63;\n}\n\n.progress-90plus .progress-bar {\n background-color: #1a9850;\n}\n\n.progress-100plus .progress-bar {\n background-color: #006837;\n}\n\n"
},
{
"path": "docs/assets/css-js/general/css/social-color-stryle.css",
"content": "/* # cspell: disable */\n\n/* Icon Fill Color Styles\n *\n * Source: https://squidfunk.github.io/mkdocs-material/reference/icons-emojis/#with-colors\n *\n */\n\n.devdotto {\n color: #0A0A0A;\n src: \"https://simpleicons.org/icons/devdotto.svg\";\n}\n\n.facebook {\n color: #4267B2;\n src: \"https://simpleicons.org/icons/facebook.svg\";\n}\n\n.github {\n color: #181717;\n src: \"https://simpleicons.org/icons/github.svg\";\n /* icon: \"https://simpleicons.org/icons/github.svg\"; */\n}\n\n.linkedin {\n color: #0A66C2;\n src: \"https://simpleicons.org/icons/linkedin.svg\";\n /* icon: \"https://simpleicons.org/icons/linkedin.svg\"; */\n}\n\n.medium {\n color: #00AB6C;\n src: \"https://simpleicons.org/icons/medium.svg\";\n /* icon: \"https://simpleicons.org/icons/medium.svg\"; */\n}\n\n.stackoverflow {\n color: #F58025;\n src: \"https://simpleicons.org/icons/stackoverflow.svg\";\n /* icon: \"https://simpleicons.org/icons/stackoverflow.svg\"; */\n}\n\n.twitter {\n color: #1DA1F2;\n src: \"https://simpleicons.org/icons/twitter.svg\";\n /* icon: \"https://simpleicons.org/icons/twitter.svg\"; */\n}\n\n.youtube {\n color: #FF0000;\n src: \"https://simpleicons.org/icons/youtube.svg\";\n /* icon: \"https://simpleicons.org/icons/youtube.svg\"; */\n}\n"
},
{
"path": "docs/assets/css-js/general/js/highlight-config.js",
"content": "// source: https://squidfunk.github.io/mkdocs-material/reference/code-blocks/#highlight\ndocument$.subscribe(() => {\n hljs.highlightAll()\n})\n"
},
{
"path": "docs/assets/css-js/general/js/material-extra/extra-uml.js",
"content": "/*\n * Source: https://github.com/facelessuser/pymdown-extensions/blob/main/docs/src/js/extra-uml.js\n */\n\nimport uml from \"./uml\"\n\n(() => {\n const onReady = function (fn) {\n document.addEventListener(\"DOMContentLoaded\", fn)\n document.addEventListener(\"DOMContentSwitch\", fn)\n }\n\n const observer = new MutationObserver(mutations => {\n mutations.forEach(mutation => {\n if (mutation.type === \"attributes\") {\n let scheme = mutation.target.getAttribute(\"data-md-color-scheme\")\n if (!scheme) {\n scheme = \"default\"\n }\n localStorage.setItem(\"data-md-color-scheme\", scheme)\n if (typeof mermaid !== \"undefined\") {\n uml(\"mermaid\")\n }\n }\n })\n })\n\n onReady(() => {\n observer.observe(document.querySelector(\"body\"), { attributeFilter: [\"data-md-color-scheme\"] })\n\n if (typeof mermaid !== \"undefined\") {\n uml(\"mermaid\")\n }\n })\n})()\n"
},
{
"path": "docs/assets/css-js/general/js/material-extra/material-extra-theme.js",
"content": "/*\n * Source: https://github.com/facelessuser/pymdown-extensions/blob/main/docs/src/js/material-extra-theme.js\n */\n\n(() => {\n\n const preferToggle = function (e) {\n if (localStorage.getItem(\"data-md-prefers-color-scheme\") === \"true\") {\n document.querySelector(\"body\").setAttribute(\"data-md-color-scheme\", (e.matches) ? \"dracula\" : \"default\")\n }\n }\n\n const setupTheme = function (body) {\n const preferSupported = window.matchMedia(\"(prefers-color-scheme)\").media !== \"not all\"\n let scheme = localStorage.getItem(\"data-md-color-scheme\")\n let prefers = localStorage.getItem(\"data-md-prefers-color-scheme\")\n\n if (!scheme) {\n scheme = \"dracula\"\n }\n if (!prefers) {\n prefers = \"false\"\n }\n\n if (prefers === \"true\" && preferSupported) {\n scheme = (window.matchMedia(\"(prefers-color-scheme: dark)\").matches) ? \"dracula\" : \"default\"\n } else {\n prefers = \"false\"\n }\n\n body.setAttribute(\"data-md-prefers-color-scheme\", prefers)\n body.setAttribute(\"data-md-color-scheme\", scheme)\n\n if (preferSupported) {\n const matchListener = window.matchMedia(\"(prefers-color-scheme: dark)\")\n matchListener.addListener(preferToggle)\n }\n }\n\n const observer = new MutationObserver(mutations => {\n mutations.forEach(mutation => {\n if (mutation.type === \"childList\") {\n if (mutation.addedNodes.length) {\n for (let i = 0; i < mutation.addedNodes.length; i++) {\n const el = mutation.addedNodes[i]\n\n if (el.nodeType === 1 && el.tagName.toLowerCase() === \"body\") {\n setupTheme(el)\n break\n }\n }\n }\n }\n })\n })\n\n observer.observe(document.querySelector(\"html\"), { childList: true })\n})()\n\nwindow.toggleScheme = function () {\n const body = document.querySelector(\"body\")\n const preferSupported = window.matchMedia(\"(prefers-color-scheme)\").media !== \"not all\"\n let scheme = body.getAttribute(\"data-md-color-scheme\")\n let prefer = body.getAttribute(\"data-md-prefers-color-scheme\")\n\n if (preferSupported && scheme === \"default\" && prefer !== \"true\") {\n prefer = \"true\"\n scheme = (window.matchMedia(\"(prefers-color-scheme: dark)\").matches) ? \"dracula\" : \"default\"\n } else if (preferSupported && prefer === \"true\") {\n prefer = \"false\"\n scheme = \"dracula\"\n } else if (scheme === \"dracula\") {\n prefer = \"false\"\n scheme = \"default\"\n } else {\n prefer = \"false\"\n scheme = \"dracula\"\n }\n localStorage.setItem(\"data-md-prefers-color-scheme\", prefer)\n body.setAttribute(\"data-md-prefers-color-scheme\", prefer)\n body.setAttribute(\"data-md-color-scheme\", scheme)\n}\n"
},
{
"path": "docs/assets/css-js/general/js/material-extra/uml.js",
"content": "/* Notes (as of Mermaid 8.7.0):\n * - Gantt: width is always relative to the parent, if you have a small parent, the chart will be squashed.\n * Can't help it.\n * - Journey: Suffers from the same issues that Gantt does.\n * - Pie: These charts have no default height or width. Good luck pinning them down to a reasonable size.\n * - Git: The render portion is agnostic to the size of the parent element. But padding of the SVG is relative\n * to the parent element. You will never find a happy size.\n *\n * Source: https://github.com/facelessuser/pymdown-extensions/blob/main/docs/src/js/uml.js\n *\n */\n\n/**\n * Targets special code or div blocks and converts them to UML.\n * @param {string} className is the name of the class to target.\n * @return {void}\n */\nexport default className => {\n\n // Custom element to encapsulate Mermaid content.\n class MermaidDiv extends HTMLElement {\n\n /**\n * Creates a special Mermaid div shadow DOM.\n * Works around issues of shared IDs.\n * @return {void}\n */\n constructor() {\n super()\n\n // Create the Shadow DOM and attach style\n const shadow = this.attachShadow({ mode: \"open\" })\n const style = document.createElement(\"style\")\n style.textContent = `\n :host {\n display: block;\n line-height: initial;\n font-size: 16px;\n }\n div.mermaid {\n margin: 0;\n overflow: visible;\n }`\n shadow.appendChild(style)\n }\n }\n\n if (typeof customElements.get(\"mermaid-div\") === \"undefined\") {\n customElements.define(\"mermaid-div\", MermaidDiv)\n }\n\n const getFromCode = function (parent) {\n // Handles text extraction.\n let text = \"\"\n for (let j = 0; j < parent.childNodes.length; j++) {\n const subEl = parent.childNodes[j]\n if (subEl.tagName.toLowerCase() === \"code\") {\n for (let k = 0; k < subEl.childNodes.length; k++) {\n const child = subEl.childNodes[k]\n const whitespace = /^\\s*$/\n if (child.nodeName === \"#text\" && !(whitespace.test(child.nodeValue))) {\n text = child.nodeValue\n break\n }\n }\n }\n }\n return text\n }\n\n // We use this to determine if we want the dark or light theme.\n // This is specific for our MkDocs Material environment.\n // You should load your configs based on your own environment's needs.\n const defaultConfig = {\n startOnLoad: false,\n theme: \"default\",\n flowchart: {\n htmlLabels: false\n },\n er: {\n useMaxWidth: false\n },\n sequence: {\n useMaxWidth: false,\n noteFontWeight: \"14px\",\n actorFontSize: \"14px\",\n messageFontSize: \"16px\"\n }\n }\n mermaid.mermaidAPI.globalReset()\n // Non Material themes should just use \"default\"\n let scheme = null\n try {\n scheme = document.querySelector(\"[data-md-color-scheme]\").getAttribute(\"data-md-color-scheme\")\n } catch (err) {\n scheme = \"default\"\n }\n const config = (typeof mermaidConfig === \"undefined\") ?\n defaultConfig :\n mermaidConfig[scheme] || (mermaidConfig.default || defaultConfig)\n mermaid.initialize(config)\n\n // Find all of our Mermaid sources and render them.\n const blocks = document.querySelectorAll(`pre.${className}, mermaid-div`)\n const surrogate = document.querySelector(\"html\")\n for (let i = 0; i < blocks.length; i++) {\n const block = blocks[i]\n const parentEl = (block.tagName.toLowerCase() === \"mermaid-div\") ?\n block.shadowRoot.querySelector(`pre.${className}`) :\n block\n\n // Create a temporary element with the typeset and size we desire.\n // Insert it at the end of our parent to render the SVG.\n const temp = document.createElement(\"div\")\n temp.style.visibility = \"hidden\"\n temp.style.display = \"display\"\n temp.style.padding = \"0\"\n temp.style.margin = \"0\"\n temp.style.lineHeight = \"initial\"\n temp.style.fontSize = \"16px\"\n surrogate.appendChild(temp)\n\n try {\n mermaid.mermaidAPI.render(\n `_mermaid_${i}`,\n getFromCode(parentEl),\n content => {\n const el = document.createElement(\"div\")\n el.className = className\n el.innerHTML = content\n\n // Insert the render where we want it and remove the original text source.\n // Mermaid will clean up the temporary element.\n const shadow = document.createElement(\"mermaid-div\")\n shadow.shadowRoot.appendChild(el)\n block.parentNode.insertBefore(shadow, block)\n parentEl.style.display = \"none\"\n shadow.shadowRoot.appendChild(parentEl)\n if (parentEl !== block) {\n block.parentNode.removeChild(block)\n }\n },\n temp\n )\n } catch (err) { } // eslint-disable-line no-empty\n\n if (surrogate.contains(temp)) {\n surrogate.removeChild(temp)\n }\n }\n}\n"
},
{
"path": "docs/assets/css-js/general/js/tables.js",
"content": "document$.subscribe(function () {\n var tables = document.querySelectorAll(\"article table\")\n tables.forEach(function (table) {\n new Tablesort(table)\n })\n})\n"
},
{
"path": "docs/assets/css-js/mkdocs-tooltips/css/custom.css",
"content": ".tooltip {\n cursor:default;\n}\n\n.icons {\n margin: 0 auto !important;\n}\n\n.icons.position {\n width: 240px; /* 3 * (10 + 60 + 10) */\n}\n\n.icons.color {\n width: 325px; /* 4 * (10 + 60 + 10) + 5 (?) */\n}\n\n@media only screen and (max-width: 400px) {\n .icons.color {\n width: 165px; /* 2 * (10 + 60 + 10) + 5 (?) */\n }\n}\n\n.icons span {\n line-height: 60px;\n display: inline-block;\n cursor: default;\n font-size: 60px;\n margin: 10px;\n padding: 0px;\n width: 60px;\n height: 60px;\n text-align: center;\n vertical-align: middle;\n}\n\n.md-button {\n text-align: center;\n margin: 10px;\n}\n\n.disabled {\n cursor: not-allowed;\n pointer-events: none;\n}\n"
},
{
"path": "docs/assets/css-js/pymdownx-extras/css/extra.css",
"content": "@charset \"UTF-8\";\n\n:root>* {\n\t--md-code-link-bg-color: hsla(0, 0%, 96%, 1);\n\t--md-code-link-accent-bg-color: var(--md-code-link-bg-color);\n\t--md-default-bg-color--trans: rgb(100%, 100%, 100%, 0);\n\t--md-code-special-bg-color: #e8e8e8;\n\t--md-code-alternate-bg-color: var(--md-code-bg-color);\n\t--md-code-hl-punctuation-color: var(--md-code-fg-color);\n\t--md-code-hl-namespace-color: var(--md-code-fg-color);\n\t--md-code-hl-entity-color: var(--md-code-hl-keyword-color);\n\t--md-code-hl-tag-color: var(--md-code-hl-keyword-color);\n\t--md-code-hl-builtin-color: var(--md-code-hl-constant-color);\n\t--md-code-hl-class-color: var(--md-code-hl-function-color);\n\t--md-typeset-a-color: #00bcd4;\n\t--md-progress-stripe: var(--md-default-bg-color--lighter);\n\t--md-progress-100: #00e676;\n\t--md-progress-80: #00e676;\n\t--md-progress-60: #fbc02d;\n\t--md-progress-40: #ff9100;\n\t--md-progress-20: #ff5252;\n\t--md-progress-0: #ff1744;\n\t--md-typeset-kbd-color: #ebebeb;\n\t--md-typeset-kbd-border-color: #b8b8b8;\n\t--md-typeset-kbd-accent-color: hsla(0, 100%, 100%, 1);\n\t--md-default-bg-color--dark: #2b2e3b;\n\t--md-default-bg-color--darker: #252732;\n\t--md-default-bg-color--darkest: #1e2029;\n\t--md-default-bg-color--ultra-dark: #111217\n}\n\n:root>[data-md-color-scheme=slate] {\n\t--md-code-link-bg-color: hsla(232, 15%, 15%, 1);\n\t--md-code-link-accent-bg-color: var(--md-code-link-bg-color);\n\t--md-code-special-bg-color: #2b2d3b;\n\t--md-default-bg-color--trans: hsla(232, 15%, 15%, 0);\n\t--md-typeset-kbd-color: var(--md-default-fg-color--lightest);\n\t--md-typeset-kbd-border-color: #1a1c24;\n\t--md-typeset-kbd-accent-color: var(--md-default-fg-color--lighter)\n}\n\n:root>[data-md-color-scheme=dracula] {\n\t--md-default-fg-color: rgba(248, 248, 242, 0.87);\n\t--md-default-fg-color--light: rgba(248, 248, 242, 0.54);\n\t--md-default-fg-color--lighter: rgba(248, 248, 242, 0.16);\n\t--md-default-fg-color--lightest: rgba(248, 248, 242, 0.07);\n\t--md-default-bg-color: var(--md-default-bg-color--darkest);\n\t--md-default-bg-color--light: rgba(50, 52, 67, 0.7);\n\t--md-default-bg-color--lighter: rgba(50, 52, 67, 0.3);\n\t--md-default-bg-color--lightest: rgba(50, 52, 67, 0.12);\n\t--md-default-bg-color--trans: rgba(50, 52, 67, 0);\n\t--md-text-color: var(--md-default-fg-color);\n\t--md-typeset-color: var(--md-default-fg-color);\n\t--md-admonition-fg-color: var(--md-default-fg-color);\n\t--md-code-fg-color: hsl(60deg, 30%, 96%);\n\t--md-code-bg-color: hsl(231deg, 15%, 18%);\n\t--md-code-inline-bg-color: #323443;\n\t--md-code-hl-operator-color: hsl(326deg, 100%, 74%);\n\t--md-code-hl-punctuation-color: hsl(60deg, 30%, 96%);\n\t--md-code-hl-string-color: hsl(65deg, 92%, 76%);\n\t--md-code-hl-special-color: hsl(265deg, 89%, 78%);\n\t--md-code-hl-number-color: hsl(265deg, 89%, 78%);\n\t--md-code-hl-keyword-color: hsl(326deg, 100%, 74%);\n\t--md-code-hl-name-color: hsl(60deg, 30%, 96%);\n\t--md-code-hl-constant-color: hsl(265deg, 89%, 78%);\n\t--md-code-hl-function-color: hsl(135deg, 94%, 65%);\n\t--md-code-hl-comment-color: hsl(225deg, 27%, 51%);\n\t--md-code-hl-variable-color: hsl(31deg, 100%, 71%);\n\t--md-code-hl-generic-color: hsl(225deg, 27%, 51%);\n\t--md-code-hl-color: hsl(231deg, 25%, 25%);\n\t--md-code-hl-entity-color: hsl(135deg, 94%, 65%);\n\t--md-code-hl-tag-color: hsl(326deg, 100%, 74%);\n\t--md-code-hl-namespace-color: hsl(60deg, 30%, 96%);\n\t--md-code-hl-builtin-color: hsl(191deg, 97%, 77%);\n\t--md-code-hl-class-color: hsl(191deg, 97%, 77%);\n\t--md-code-special-bg-color: #1c1e26;\n\t--md-code-alternate-bg-color: #3d3e49;\n\t--md-code-link-bg-color: #364653;\n\t--md-typeset-a-color: hsl(191deg, 97%, 77%);\n\t--md-typeset-mark-color: #6e7252;\n\t--md-typeset-del-color: #734568;\n\t--md-typeset-ins-color: #36724e;\n\t--md-progress-stripe: var(--md-default-bg-color--lightest);\n\t--md-progress-100: hsl(135deg, 94%, 65%);\n\t--md-progress-80: hsl(135deg, 92%, 79%);\n\t--md-progress-60: hsl(65deg, 92%, 76%);\n\t--md-progress-40: hsl(31deg, 100%, 71%);\n\t--md-progress-20: hsl(326deg, 100%, 74%);\n\t--md-progress-0: hsl(0deg, 100%, 67%);\n\t--md-typeset-kbd-color: var(--md-default-fg-color--lightest);\n\t--md-typeset-kbd-border-color: var(--md-default-bg-color--ultra-dark);\n\t--md-typeset-kbd-accent-color: var(--md-default-fg-color--lighter)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=red],\n[data-md-color-scheme=dracula][data-md-color-primary=red] {\n\t--md-primary-code-bg-color: #47303a;\n\t--md-primary-fg-color: hsla(0deg, 100%, 67%, 1);\n\t--md-primary-fg-color--transparent: hsla(0deg, 100%, 67%, 0.1);\n\t--md-primary-fg-color--light: hsla(0deg, 100%, 72%, 1);\n\t--md-primary-fg-color--dark: hsla(0deg, 100%, 62%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=pink],\n[data-md-color-scheme=dracula][data-md-color-primary=pink] {\n\t--md-primary-code-bg-color: #47354b;\n\t--md-primary-fg-color: hsla(326deg, 100%, 74%, 1);\n\t--md-primary-fg-color--transparent: hsla(326deg, 100%, 74%, 0.1);\n\t--md-primary-fg-color--light: hsla(326deg, 100%, 79%, 1);\n\t--md-primary-fg-color--dark: hsla(326deg, 100%, 69%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=purple],\n[data-md-color-scheme=dracula][data-md-color-primary=purple] {\n\t--md-primary-code-bg-color: #3e3952;\n\t--md-primary-fg-color: hsla(265deg, 89%, 78%, 1);\n\t--md-primary-fg-color--transparent: hsla(265deg, 89%, 78%, 0.1);\n\t--md-primary-fg-color--light: hsla(265deg, 89%, 83%, 1);\n\t--md-primary-fg-color--dark: hsla(265deg, 89%, 73%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=deep-purple],\n[data-md-color-scheme=dracula][data-md-color-primary=deep-purple] {\n\t--md-primary-code-bg-color: #3e3952;\n\t--md-primary-fg-color: hsla(265deg, 89%, 78%, 1);\n\t--md-primary-fg-color--transparent: hsla(265deg, 89%, 78%, 0.1);\n\t--md-primary-fg-color--light: hsla(265deg, 89%, 83%, 1);\n\t--md-primary-fg-color--dark: hsla(265deg, 89%, 73%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=blue],\n[data-md-color-scheme=dracula][data-md-color-primary=blue] {\n\t--md-primary-code-bg-color: #303446;\n\t--md-primary-fg-color: hsla(225deg, 27%, 51%, 1);\n\t--md-primary-fg-color--transparent: hsla(225deg, 27%, 51%, 0.1);\n\t--md-primary-fg-color--light: hsla(225deg, 27%, 56%, 1);\n\t--md-primary-fg-color--dark: hsla(225deg, 27%, 46%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=indigo],\n[data-md-color-scheme=dracula][data-md-color-primary=indigo] {\n\t--md-primary-code-bg-color: #303446;\n\t--md-primary-fg-color: hsla(225deg, 27%, 51%, 1);\n\t--md-primary-fg-color--transparent: hsla(225deg, 27%, 51%, 0.1);\n\t--md-primary-fg-color--light: hsla(225deg, 27%, 56%, 1);\n\t--md-primary-fg-color--dark: hsla(225deg, 27%, 46%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=light-blue],\n[data-md-color-scheme=dracula][data-md-color-primary=light-blue] {\n\t--md-primary-code-bg-color: #303446;\n\t--md-primary-fg-color: hsla(225deg, 27%, 51%, 1);\n\t--md-primary-fg-color--transparent: hsla(225deg, 27%, 51%, 0.1);\n\t--md-primary-fg-color--light: hsla(225deg, 27%, 56%, 1);\n\t--md-primary-fg-color--dark: hsla(225deg, 27%, 46%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=cyan],\n[data-md-color-scheme=dracula][data-md-color-primary=cyan] {\n\t--md-primary-code-bg-color: #364653;\n\t--md-primary-fg-color: hsla(191deg, 97%, 77%, 1);\n\t--md-primary-fg-color--transparent: hsla(191deg, 97%, 77%, 0.1);\n\t--md-primary-fg-color--light: hsla(191deg, 97%, 82%, 1);\n\t--md-primary-fg-color--dark: hsla(191deg, 97%, 72%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=teal],\n[data-md-color-scheme=dracula][data-md-color-primary=teal] {\n\t--md-primary-code-bg-color: #364653;\n\t--md-primary-fg-color: hsla(191deg, 97%, 77%, 1);\n\t--md-primary-fg-color--transparent: hsla(191deg, 97%, 77%, 0.1);\n\t--md-primary-fg-color--light: hsla(191deg, 97%, 82%, 1);\n\t--md-primary-fg-color--dark: hsla(191deg, 97%, 72%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=green],\n[data-md-color-scheme=dracula][data-md-color-primary=green] {\n\t--md-primary-code-bg-color: #2d4840;\n\t--md-primary-fg-color: hsla(135deg, 94%, 65%, 1);\n\t--md-primary-fg-color--transparent: hsla(135deg, 94%, 65%, 0.1);\n\t--md-primary-fg-color--light: hsla(135deg, 94%, 70%, 1);\n\t--md-primary-fg-color--dark: hsla(135deg, 94%, 60%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=light-green],\n[data-md-color-scheme=dracula][data-md-color-primary=light-green] {\n\t--md-primary-code-bg-color: #2d4840;\n\t--md-primary-fg-color: hsla(135deg, 94%, 65%, 1);\n\t--md-primary-fg-color--transparent: hsla(135deg, 94%, 65%, 0.1);\n\t--md-primary-fg-color--light: hsla(135deg, 94%, 70%, 1);\n\t--md-primary-fg-color--dark: hsla(135deg, 94%, 60%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=lime],\n[data-md-color-scheme=dracula][data-md-color-primary=lime] {\n\t--md-primary-code-bg-color: #2d4840;\n\t--md-primary-fg-color: hsla(135deg, 94%, 65%, 1);\n\t--md-primary-fg-color--transparent: hsla(135deg, 94%, 65%, 0.1);\n\t--md-primary-fg-color--light: hsla(135deg, 94%, 70%, 1);\n\t--md-primary-fg-color--dark: hsla(135deg, 94%, 60%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=yellow],\n[data-md-color-scheme=dracula][data-md-color-primary=yellow] {\n\t--md-primary-code-bg-color: #454842;\n\t--md-primary-fg-color: hsla(65deg, 92%, 76%, 1);\n\t--md-primary-fg-color--transparent: hsla(65deg, 92%, 76%, 0.1);\n\t--md-primary-fg-color--light: hsla(65deg, 92%, 81%, 1);\n\t--md-primary-fg-color--dark: hsla(65deg, 92%, 71%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=amber],\n[data-md-color-scheme=dracula][data-md-color-primary=amber] {\n\t--md-primary-code-bg-color: #454842;\n\t--md-primary-fg-color: hsla(65deg, 92%, 76%, 1);\n\t--md-primary-fg-color--transparent: hsla(65deg, 92%, 76%, 0.1);\n\t--md-primary-fg-color--light: hsla(65deg, 92%, 81%, 1);\n\t--md-primary-fg-color--dark: hsla(65deg, 92%, 71%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=orange],\n[data-md-color-scheme=dracula][data-md-color-primary=orange] {\n\t--md-primary-code-bg-color: #473e3d;\n\t--md-primary-fg-color: hsla(31deg, 100%, 71%, 1);\n\t--md-primary-fg-color--transparent: hsla(31deg, 100%, 71%, 0.1);\n\t--md-primary-fg-color--light: hsla(31deg, 100%, 76%, 1);\n\t--md-primary-fg-color--dark: hsla(31deg, 100%, 66%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=deep-orange],\n[data-md-color-scheme=dracula][data-md-color-primary=deep-orange] {\n\t--md-primary-code-bg-color: #473e3d;\n\t--md-primary-fg-color: hsla(31deg, 100%, 71%, 1);\n\t--md-primary-fg-color--transparent: hsla(31deg, 100%, 71%, 0.1);\n\t--md-primary-fg-color--light: hsla(31deg, 100%, 76%, 1);\n\t--md-primary-fg-color--dark: hsla(31deg, 100%, 66%, 1);\n\t--md-primary-bg-color: var(--md-default-bg-color);\n\t--md-primary-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=red],\n[data-md-color-scheme=dracula][data-md-color-accent=red] {\n\t--md-code-link-accent-bg-color: #472c36;\n\t--md-accent-fg-color: hsla(0deg, 100%, 62%, 1);\n\t--md-accent-fg-color--transparent: hsla(0deg, 100%, 62%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=pink],\n[data-md-color-scheme=dracula][data-md-color-accent=pink] {\n\t--md-code-link-accent-bg-color: #473149;\n\t--md-accent-fg-color: hsla(326deg, 100%, 69%, 1);\n\t--md-accent-fg-color--transparent: hsla(326deg, 100%, 69%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=purple],\n[data-md-color-scheme=dracula][data-md-color-accent=purple] {\n\t--md-code-link-accent-bg-color: #3c3652;\n\t--md-accent-fg-color: hsla(265deg, 89%, 73%, 1);\n\t--md-accent-fg-color--transparent: hsla(265deg, 89%, 73%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=deep-purple],\n[data-md-color-scheme=dracula][data-md-color-accent=deep-purple] {\n\t--md-code-link-accent-bg-color: #3c3652;\n\t--md-accent-fg-color: hsla(265deg, 89%, 73%, 1);\n\t--md-accent-fg-color--transparent: hsla(265deg, 89%, 73%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=blue],\n[data-md-color-scheme=dracula][data-md-color-accent=blue] {\n\t--md-code-link-accent-bg-color: #2e3243;\n\t--md-accent-fg-color: hsla(225deg, 27%, 46%, 1);\n\t--md-accent-fg-color--transparent: hsla(225deg, 27%, 46%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=indigo],\n[data-md-color-scheme=dracula][data-md-color-accent=indigo] {\n\t--md-code-link-accent-bg-color: #2e3243;\n\t--md-accent-fg-color: hsla(225deg, 27%, 46%, 1);\n\t--md-accent-fg-color--transparent: hsla(225deg, 27%, 46%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=light-blue],\n[data-md-color-scheme=dracula][data-md-color-accent=light-blue] {\n\t--md-code-link-accent-bg-color: #2e3243;\n\t--md-accent-fg-color: hsla(225deg, 27%, 46%, 1);\n\t--md-accent-fg-color--transparent: hsla(225deg, 27%, 46%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=cyan],\n[data-md-color-scheme=dracula][data-md-color-accent=cyan] {\n\t--md-code-link-accent-bg-color: #324553;\n\t--md-accent-fg-color: hsla(191deg, 97%, 72%, 1);\n\t--md-accent-fg-color--transparent: hsla(191deg, 97%, 72%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=teal],\n[data-md-color-scheme=dracula][data-md-color-accent=teal] {\n\t--md-code-link-accent-bg-color: #324553;\n\t--md-accent-fg-color: hsla(191deg, 97%, 72%, 1);\n\t--md-accent-fg-color--transparent: hsla(191deg, 97%, 72%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=green],\n[data-md-color-scheme=dracula][data-md-color-accent=green] {\n\t--md-code-link-accent-bg-color: #2a483d;\n\t--md-accent-fg-color: hsla(135deg, 94%, 60%, 1);\n\t--md-accent-fg-color--transparent: hsla(135deg, 94%, 60%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=light-green],\n[data-md-color-scheme=dracula][data-md-color-accent=light-green] {\n\t--md-code-link-accent-bg-color: #2a483d;\n\t--md-accent-fg-color: hsla(135deg, 94%, 60%, 1);\n\t--md-accent-fg-color--transparent: hsla(135deg, 94%, 60%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=lime],\n[data-md-color-scheme=dracula][data-md-color-accent=lime] {\n\t--md-code-link-accent-bg-color: #2a483d;\n\t--md-accent-fg-color: hsla(135deg, 94%, 60%, 1);\n\t--md-accent-fg-color--transparent: hsla(135deg, 94%, 60%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=yellow],\n[data-md-color-scheme=dracula][data-md-color-accent=yellow] {\n\t--md-code-link-accent-bg-color: #45483e;\n\t--md-accent-fg-color: hsla(65deg, 92%, 71%, 1);\n\t--md-accent-fg-color--transparent: hsla(65deg, 92%, 71%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=amber],\n[data-md-color-scheme=dracula][data-md-color-accent=amber] {\n\t--md-code-link-accent-bg-color: #45483e;\n\t--md-accent-fg-color: hsla(65deg, 92%, 71%, 1);\n\t--md-accent-fg-color--transparent: hsla(65deg, 92%, 71%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=orange],\n[data-md-color-scheme=dracula][data-md-color-accent=orange] {\n\t--md-code-link-accent-bg-color: #473d39;\n\t--md-accent-fg-color: hsla(31deg, 100%, 66%, 1);\n\t--md-accent-fg-color--transparent: hsla(31deg, 100%, 66%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n[data-md-color-scheme=dracula] :not([data-md-color-scheme])[data-md-color-primary=deep-orange],\n[data-md-color-scheme=dracula][data-md-color-accent=deep-orange] {\n\t--md-code-link-accent-bg-color: #473d39;\n\t--md-accent-fg-color: hsla(31deg, 100%, 66%, 1);\n\t--md-accent-fg-color--transparent: hsla(31deg, 100%, 66%, 0.1);\n\t--md-accent-bg-color: var(--md-default-bg-color);\n\t--md-accent-bg-color--light: var(--md-default-bg-color--light)\n}\n\n:root {\n\t--md-heart: #ff5252;\n\t--md-heart-big: #ff1744\n}\n\n:root [data-md-color-scheme=dracula] {\n\t--md-heart: hsl(326deg, 100%, 74%);\n\t--md-heart-big: hsl(0deg, 100%, 67%)\n}\n\n.md-typeset a.source-link {\n\tposition: relative;\n\ttop: -.6rem;\n\tfloat: right;\n\tcolor: var(--md-default-fg-color--lighter);\n\ttransition: color 125ms\n}\n\n.md-typeset a.source-link:hover {\n\tcolor: var(--md-accent-fg-color)\n}\n\n.md-typeset a.source-link .twemoji {\n\theight: 1.2rem\n}\n\n.md-typeset a.source-link .twemoji svg {\n\twidth: 1.2rem;\n\theight: 1.2rem\n}\n\n.md-typeset div.highlight.md-max-height pre>code {\n\tmax-height: 15rem\n}\n\n.twemoji.heart-throb svg,\n.twemoji.heart-throb-hover svg {\n\tposition: relative;\n\tcolor: var(--md-heart);\n\t-webkit-animation: pulse 1.5s ease infinite;\n\tanimation: pulse 1.5s ease infinite\n}\n\n@-webkit-keyframes pulse {\n\t0% {\n\t\ttransform: scale(1)\n\t}\n\n\t40% {\n\t\tcolor: var(--md-heart-big);\n\t\ttransform: scale(1.3)\n\t}\n\n\t50% {\n\t\ttransform: scale(1.2)\n\t}\n\n\t60% {\n\t\tcolor: var(--md-heart-big);\n\t\ttransform: scale(1.3)\n\t}\n\n\t100% {\n\t\ttransform: scale(1)\n\t}\n}\n\n@keyframes pulse {\n\t0% {\n\t\ttransform: scale(1)\n\t}\n\n\t40% {\n\t\tcolor: var(--md-heart-big);\n\t\ttransform: scale(1.3)\n\t}\n\n\t50% {\n\t\ttransform: scale(1.2)\n\t}\n\n\t60% {\n\t\tcolor: var(--md-heart-big);\n\t\ttransform: scale(1.3)\n\t}\n\n\t100% {\n\t\ttransform: scale(1)\n\t}\n}\n\nfooter.sponsorship {\n\ttext-align: center\n}\n\nfooter.sponsorship hr {\n\tdisplay: inline-block;\n\twidth: 1.6rem;\n\tmargin: 0 .7rem;\n\tvertical-align: middle;\n\tborder-bottom: 2px solid var(--md-default-fg-color--lighter)\n}\n\nfooter.sponsorship:hover hr {\n\tborder-color: var(--md-accent-fg-color)\n}\n\nfooter.sponsorship:not(:hover) .twemoji.heart-throb-hover svg {\n\tcolor: var(--md-default-fg-color--lighter) !important\n}\n\nbody:not([data-md-prefers-color-scheme=true])[data-md-color-scheme=dracula] .md-icon .light-mode,\nbody:not([data-md-prefers-color-scheme=true])[data-md-color-scheme=dracula] .md-icon .system-mode,\nbody:not([data-md-prefers-color-scheme=true])[data-md-color-scheme=dracula] .md-icon .unknown-mode {\n\tdisplay: none\n}\n\nbody:not([data-md-prefers-color-scheme=true])[data-md-color-scheme=default] .md-icon .dark-mode,\nbody:not([data-md-prefers-color-scheme=true])[data-md-color-scheme=default] .md-icon .system-mode,\nbody:not([data-md-prefers-color-scheme=true])[data-md-color-scheme=default] .md-icon .unknown-mode {\n\tdisplay: none\n}\n\nbody:not([data-md-prefers-color-scheme=true]):not([data-md-color-scheme=default]):not([data-md-color-scheme=dracula]) .md-icon .dark-mode,\nbody:not([data-md-prefers-color-scheme=true]):not([data-md-color-scheme=default]):not([data-md-color-scheme=dracula]) .md-icon .light-mode,\nbody:not([data-md-prefers-color-scheme=true]):not([data-md-color-scheme=default]):not([data-md-color-scheme=dracula]) .md-icon .system-mode {\n\tdisplay: none\n}\n\nbody[data-md-prefers-color-scheme=true] .md-icon .dark-mode,\nbody[data-md-prefers-color-scheme=true] .md-icon .light-mode,\nbody[data-md-prefers-color-scheme=true] .md-icon .unknown-mode {\n\tdisplay: none\n}\n\n.md-header-nav__scheme {\n\tz-index: 0\n}\n\n[data-md-toggle=search]:checked~.md-header .md-header-nav__scheme {\n\tdisplay: none\n}\n\n:root>* {\n\t--md-admonition-bg-color: transparent;\n\t--md-admonition-icon--settings: url('data:image/svg+xml;charset=utf-8,\n * @version 0.0.1\n * @license MIT\n */\n\n:root {\n --color-bg: #252a33;\n --color-text: #eee;\n --color-text-subtle: #a2a2a2;\n}\n\n[data-termynal] {\n width: 750px;\n max-width: 100%;\n background: var(--color-bg);\n color: var(--color-text);\n /* font-size: 18px; */\n font-size: 15px;\n /* font-family: 'Fira Mono', Consolas, Menlo, Monaco, 'Courier New', Courier, monospace; */\n font-family: 'Roboto Mono', 'Fira Mono', Consolas, Menlo, Monaco, 'Courier New', Courier, monospace;\n border-radius: 4px;\n padding: 75px 45px 35px;\n position: relative;\n -webkit-box-sizing: border-box;\n box-sizing: border-box;\n}\n\n[data-termynal]:before {\n content: '';\n position: absolute;\n top: 15px;\n left: 15px;\n display: inline-block;\n width: 15px;\n height: 15px;\n border-radius: 50%;\n /* A little hack to display the window buttons in one pseudo element. */\n background: #d9515d;\n -webkit-box-shadow: 25px 0 0 #f4c025, 50px 0 0 #3ec930;\n box-shadow: 25px 0 0 #f4c025, 50px 0 0 #3ec930;\n}\n\n[data-termynal]:after {\n content: 'bash';\n position: absolute;\n color: var(--color-text-subtle);\n top: 5px;\n left: 0;\n width: 100%;\n text-align: center;\n}\n\na[data-terminal-control] {\n text-align: right;\n display: block;\n color: #aebbff;\n}\n\n[data-ty] {\n display: block;\n line-height: 2;\n}\n\n[data-ty]:before {\n /* Set up defaults and ensure empty lines are displayed. */\n content: '';\n display: inline-block;\n vertical-align: middle;\n}\n\n[data-ty=\"input\"]:before,\n[data-ty-prompt]:before {\n margin-right: 0.75em;\n color: var(--color-text-subtle);\n}\n\n[data-ty=\"input\"]:before {\n content: '$';\n}\n\n[data-ty][data-ty-prompt]:before {\n content: attr(data-ty-prompt);\n}\n\n[data-ty-cursor]:after {\n content: attr(data-ty-cursor);\n font-family: monospace;\n margin-left: 0.5em;\n -webkit-animation: blink 1s infinite;\n animation: blink 1s infinite;\n}\n\n\n/* Cursor animation */\n\n@-webkit-keyframes blink {\n 50% {\n opacity: 0;\n }\n}\n\n@keyframes blink {\n 50% {\n opacity: 0;\n }\n}\n"
},
{
"path": "docs/assets/css-js/termynal/js/custom.js",
"content": "function setupTermynal() {\n document.querySelectorAll(\".use-termynal\").forEach(node => {\n node.style.display = \"block\";\n new Termynal(node, {\n lineDelay: 500\n });\n });\n const progressLiteralStart = \"---> 100%\";\n const promptLiteralStart = \"$ \";\n const customPromptLiteralStart = \"# \";\n const termynalActivateClass = \"termy\";\n let termynals = [];\n\n function createTermynals() {\n document\n .querySelectorAll(`.${termynalActivateClass} .highlight`)\n .forEach(node => {\n const text = node.textContent;\n const lines = text.split(\"\\n\");\n const useLines = [];\n let buffer = [];\n function saveBuffer() {\n if (buffer.length) {\n let isBlankSpace = true;\n buffer.forEach(line => {\n if (line) {\n isBlankSpace = false;\n }\n });\n dataValue = {};\n if (isBlankSpace) {\n dataValue[\"delay\"] = 0;\n }\n if (buffer[buffer.length - 1] === \"\") {\n // A last single \n * @version 0.0.1\n * @license MIT\n */\n\n'use strict';\n\n/** Generate a terminal widget. */\nclass Termynal {\n /**\n * Construct the widget's settings.\n * @param {(string|Node)=} container - Query selector or container element.\n * @param {Object=} options - Custom settings.\n * @param {string} options.prefix - Prefix to use for data attributes.\n * @param {number} options.startDelay - Delay before animation, in ms.\n * @param {number} options.typeDelay - Delay between each typed character, in ms.\n * @param {number} options.lineDelay - Delay between each line, in ms.\n * @param {number} options.progressLength - Number of characters displayed as progress bar.\n * @param {string} options.progressChar β Character to use for progress bar, defaults to β.\n * @param {number} options.progressPercent - Max percent of progress.\n * @param {string} options.cursor β Character to use for cursor, defaults to β.\n * @param {Object[]} lineData - Dynamically loaded line data objects.\n * @param {boolean} options.noInit - Don't initialise the animation.\n */\n constructor(container = '#termynal', options = {}) {\n this.container = (typeof container === 'string') ? document.querySelector(container) : container;\n this.pfx = `data-${options.prefix || 'ty'}`;\n this.originalStartDelay = this.startDelay = options.startDelay\n || parseFloat(this.container.getAttribute(`${this.pfx}-startDelay`)) || 600;\n this.originalTypeDelay = this.typeDelay = options.typeDelay\n || parseFloat(this.container.getAttribute(`${this.pfx}-typeDelay`)) || 90;\n this.originalLineDelay = this.lineDelay = options.lineDelay\n || parseFloat(this.container.getAttribute(`${this.pfx}-lineDelay`)) || 1500;\n this.progressLength = options.progressLength\n || parseFloat(this.container.getAttribute(`${this.pfx}-progressLength`)) || 40;\n this.progressChar = options.progressChar\n || this.container.getAttribute(`${this.pfx}-progressChar`) || 'β';\n this.progressPercent = options.progressPercent\n || parseFloat(this.container.getAttribute(`${this.pfx}-progressPercent`)) || 100;\n this.cursor = options.cursor\n || this.container.getAttribute(`${this.pfx}-cursor`) || 'β';\n this.lineData = this.lineDataToElements(options.lineData || []);\n this.loadLines()\n if (!options.noInit) this.init()\n }\n\n loadLines() {\n // Load all the lines and create the container so that the size is fixed\n // Otherwise it would be changing and the user viewport would be constantly\n // moving as she/he scrolls\n const finish = this.generateFinish()\n finish.style.visibility = 'hidden'\n this.container.appendChild(finish)\n // Appends dynamically loaded lines to existing line elements.\n this.lines = [...this.container.querySelectorAll(`[${this.pfx}]`)].concat(this.lineData);\n for (let line of this.lines) {\n line.style.visibility = 'hidden'\n this.container.appendChild(line)\n }\n const restart = this.generateRestart()\n restart.style.visibility = 'hidden'\n this.container.appendChild(restart)\n this.container.setAttribute('data-termynal', '');\n }\n\n /**\n * Initialise the widget, get lines, clear container and start animation.\n */\n init() {\n /**\n * Calculates width and height of Termynal container.\n * If container is empty and lines are dynamically loaded, defaults to browser `auto` or CSS.\n */\n const containerStyle = getComputedStyle(this.container);\n this.container.style.width = containerStyle.width !== '0px' ?\n containerStyle.width : undefined;\n this.container.style.minHeight = containerStyle.height !== '0px' ?\n containerStyle.height : undefined;\n\n this.container.setAttribute('data-termynal', '');\n this.container.innerHTML = '';\n for (let line of this.lines) {\n line.style.visibility = 'visible'\n }\n this.start();\n }\n\n /**\n * Start the animation and rener the lines depending on their data attributes.\n */\n async start() {\n this.addFinish()\n await this._wait(this.startDelay);\n\n for (let line of this.lines) {\n const type = line.getAttribute(this.pfx);\n const delay = line.getAttribute(`${this.pfx}-delay`) || this.lineDelay;\n\n if (type == 'input') {\n line.setAttribute(`${this.pfx}-cursor`, this.cursor);\n await this.type(line);\n await this._wait(delay);\n }\n\n else if (type == 'progress') {\n await this.progress(line);\n await this._wait(delay);\n }\n\n else {\n this.container.appendChild(line);\n await this._wait(delay);\n }\n\n line.removeAttribute(`${this.pfx}-cursor`);\n }\n this.addRestart()\n this.finishElement.style.visibility = 'hidden'\n this.lineDelay = this.originalLineDelay\n this.typeDelay = this.originalTypeDelay\n this.startDelay = this.originalStartDelay\n }\n\n generateRestart() {\n const restart = document.createElement('a')\n restart.onclick = (e) => {\n e.preventDefault()\n this.container.innerHTML = ''\n this.init()\n }\n restart.href = '#'\n restart.setAttribute('data-terminal-control', '')\n restart.innerHTML = \"restart β»\"\n return restart\n }\n\n generateFinish() {\n const finish = document.createElement('a')\n finish.onclick = (e) => {\n e.preventDefault()\n this.lineDelay = 0\n this.typeDelay = 0\n this.startDelay = 0\n }\n finish.href = '#'\n finish.setAttribute('data-terminal-control', '')\n finish.innerHTML = \"fast β\"\n this.finishElement = finish\n return finish\n }\n\n addRestart() {\n const restart = this.generateRestart()\n this.container.appendChild(restart)\n }\n\n addFinish() {\n const finish = this.generateFinish()\n this.container.appendChild(finish)\n }\n\n /**\n * Animate a typed line.\n * @param {Node} line - The line element to render.\n */\n async type(line) {\n const chars = [...line.textContent];\n line.textContent = '';\n this.container.appendChild(line);\n\n for (let char of chars) {\n const delay = line.getAttribute(`${this.pfx}-typeDelay`) || this.typeDelay;\n await this._wait(delay);\n line.textContent += char;\n }\n }\n\n /**\n * Animate a progress bar.\n * @param {Node} line - The line element to render.\n */\n async progress(line) {\n const progressLength = line.getAttribute(`${this.pfx}-progressLength`)\n || this.progressLength;\n const progressChar = line.getAttribute(`${this.pfx}-progressChar`)\n || this.progressChar;\n const chars = progressChar.repeat(progressLength);\n const progressPercent = line.getAttribute(`${this.pfx}-progressPercent`)\n || this.progressPercent;\n line.textContent = '';\n this.container.appendChild(line);\n\n for (let i = 1; i < chars.length + 1; i++) {\n await this._wait(this.typeDelay);\n const percent = Math.round(i / chars.length * 100);\n line.textContent = `${chars.slice(0, i)} ${percent}%`;\n if (percent > progressPercent) {\n break;\n }\n }\n }\n\n /**\n * Helper function for animation delays, called with `await`.\n * @param {number} time - Timeout, in ms.\n */\n _wait(time) {\n return new Promise(resolve => setTimeout(resolve, time));\n }\n\n /**\n * Converts line data objects into line elements.\n *\n * @param {Object[]} lineData - Dynamically loaded lines.\n * @param {Object} line - Line data object.\n * @returns {Element[]} - Array of line elements.\n */\n lineDataToElements(lineData) {\n return lineData.map(line => {\n let div = document.createElement('div');\n div.innerHTML = `${line.value || ''} `;\n\n return div.firstElementChild;\n });\n }\n\n /**\n * Helper function for generating attributes string.\n *\n * @param {Object} line - Line data object.\n * @returns {string} - String of attributes.\n */\n _attributes(line) {\n let attrs = '';\n for (let prop in line) {\n // Custom add class\n if (prop === 'class') {\n attrs += ` class=${line[prop]} `\n continue\n }\n if (prop === 'type') {\n attrs += `${this.pfx}=\"${line[prop]}\" `\n } else if (prop !== 'value') {\n attrs += `${this.pfx}-${prop}=\"${line[prop]}\" `\n }\n }\n return attrs;\n }\n}\n\n/**\n* HTML API: If current script has container(s) specified, initialise Termynal.\n*/\nif (document.currentScript.hasAttribute('data-termynal-container')) {\n const containers = document.currentScript.getAttribute('data-termynal-container');\n containers.split('|')\n .forEach(container => new Termynal(container))\n}\n"
},
{
"path": "docs/assets/css-js/termynal/readme.md",
"content": "# **Termynal**: Terminal Animation\n\nJust copy and paste the `terminal` folder in a `docs/assests`\nfolder and then add the following snippet to your `mkdocs.yml`.\n\n```yaml\n# for terminal animation\nextra_css:\n - assets/termynal/css/termynal.css\n - assets/termynal/css/custom.css\n\nextra_javascript:\n - assets/termynal/js/termynal.js\n - assets/termynal/js/custom.js\n``\n"
},
{
"path": "docs/assets/snippets/macros/.gitkeep",
"content": ""
},
{
"path": "docs/assets/snippets/notifications/videos/disclaimer.md",
"content": "!!! warning \"Disclaimer\"\n\n This library is currently under rapid initial development. Breaking changes may happen frequently.\n"
},
{
"path": "docs/examples/hanoi.py",
"content": "# Based on the following example from Diagrams\n# https://archives.haskell.org/projects.haskell.org/diagrams/gallery/Hanoi.html\n\nfrom PIL import Image as PILImage\nfrom typing import Dict, List, Tuple\n\nfrom colour import Color # type: ignore\nfrom chalk import Diagram, rectangle, concat, hcat, vcat\n\n\nDisk = int\nStack = List[Disk] # disks on one peg\nHanoi = List[Stack] # disks on all three pegs\nMove = Tuple[int, int]\n\ncolors: List[Color] = [\n Color(\"#9FB4CC\"),\n Color(\"#CCCC9F\"),\n Color(\"#DB4105\"),\n]\nblack = Color(\"black\")\n\n\ndef draw_disk(n: Disk) -> Diagram:\n return (\n rectangle(n + 2, 1)\n .fill_color(colors[n])\n .line_color(colors[n])\n .line_width(0.05)\n )\ndraw_disk(0)\n\n\ndef draw_stack(s: Stack) -> Diagram:\n disks = vcat(map(draw_disk, s))\n post = rectangle(0.8, 6).fill_color(black)\n return post.align_b() + disks.align_b()\ndraw_stack([0, 1])\n\n\ndef draw_hanoi(state: Hanoi) -> Diagram:\n hsep = 7\n return concat(\n draw_stack(stack).translate(7 * i, 0) for i, stack in enumerate(state)\n )\ndraw_hanoi([[0], [1, 2], []])\n\ndef solve_hanoi(num_disks: int) -> List[Move]:\n def solve_hanoi_1(num_disks, *, source, spare, target):\n if num_disks <= 0:\n return []\n else:\n return (\n solve_hanoi_1(num_disks - 1, source=source, spare=target, target=spare)\n + [(source, target)]\n + solve_hanoi_1(num_disks - 1, source=spare, spare=source, target=target)\n )\n\n return solve_hanoi_1(num_disks, source=0, spare=1, target=2)\n\n\ndef do_move(move: Move, state: Hanoi) -> Hanoi:\n def remove_disk(src, state):\n disk, *src_new = state[src]\n state_new = state[:src] + [src_new] + state[src + 1 :]\n return disk, state_new\n\n def add_disk(tgt, disk, state):\n tgt_new = [disk] + state[tgt]\n state_new = state[:tgt] + [tgt_new] + state[tgt + 1 :]\n return state_new\n\n src, tgt = move\n disk, state1 = remove_disk(src, state)\n state2 = add_disk(tgt, disk, state1)\n return state2\n\n\ndef state_sequence(num_disks: int) -> List[Hanoi]:\n state: Hanoi = [list(range(num_disks)), [], []]\n states: List[Hanoi] = [state]\n for move in solve_hanoi(num_disks):\n state = do_move(move, state)\n states.append(state)\n return states\n\n\ndef draw_state_sequence(seq: List[Hanoi]) -> Diagram:\n return concat(draw_hanoi(state).translate(0, 7.5 * i) for i, state in enumerate(seq))\n\n\ndiagram = draw_state_sequence(state_sequence(3))\n\n\npath = \"examples/output/hanoi.svg\"\ndiagram.render_svg(path, height=700)\npath = \"examples/output/hanoi.png\"\ndiagram.render(path, height=700)\nPILImage.open(path)\n"
},
{
"path": "docs/examples/koch.py",
"content": "# Based on the following example from Diagrams\n# https://archives.haskell.org/projects.haskell.org/diagrams/gallery/Koch.html\n\nfrom PIL import Image as PILImage\nfrom chalk import *\nfrom chalk.transform import *\nimport chalk\n\nunit_x = Trail.hrule(1)\n\ndef koch(n):\n if n == 0:\n return unit_x.scale_x(5)\n else:\n return (\n koch(n - 1).scale(1 / 3)\n + koch(n - 1).scale(1 / 3).rotate_by(+1 / 6)\n + koch(n - 1).scale(1 / 3).rotate_by(-1 / 6)\n + koch(n - 1).scale(1 / 3)\n )\n\nd = vcat(koch(i).stroke().line_width(0.01) for i in range(1, 5))\n\n\n# Render\nheight = 512\nd.render_svg(\"examples/output/koch.svg\", height)\nd.render(\"examples/output/koch.png\", height)\nPILImage.open(\"examples/output/koch.png\")\n"
},
{
"path": "docs/examples/lenet.py",
"content": "from PIL import Image as PILImage\nfrom chalk import *\nfrom colour import Color\nfrom chalk import BoundingBox\n\n# Colors\npapaya = Color(\"#ff9700\")\nblue = Color(\"#005FDB\")\nblack = Color(\"#000000\")\nwhite = Color(\"#ffffff\")\ngrey = Color(\"#bbbbbb\")\n\n\n# Some general functions\n\ndef label(te):\n \"Create text.\"\n return text(te, 2).fill_color(black).line_width(0)\n\ndef cover(d, a, b):\n \"Draw a bounding_box around a subdiagram\"\n b1 = d.get_subdiagram_envelope(a)\n b2 = d.get_subdiagram_envelope(b)\n new_bb = b1 + b2\n return rectangle(new_bb.width, new_bb.height) \\\n .translate(new_bb.center.x, new_bb.center.y)\n\ndef tile(d, m, n, name = \"\"):\n \"Tile a digram with names\"\n return hcat(vcat(d.named((name, j, i)) for j in range(n)) for i in range(m)).center_xy()\n\ndef connect_all(d, a, b):\n \"Connect all corners of two diagrams\"\n\n for x_border in [-unit_x, unit_x]:\n for y_border in [-unit_y, unit_y]:\n p = x_border + y_border\n d = d.connect_perim(a, b, p, p, ArrowOpts(head_arrow=empty()))\n return d\n\n# NN drawing\ndef cell():\n return rectangle(1, 1).line_width(0.01)\n\ndef matrix(n, r, c):\n return tile(cell(), c, r, n)\n\ndef back(r, n):\n \"Backing stack\"\n return concat((r.translate(-i/2, -i/2).fill_opacity((n - i + n /2) / n)\n for i in range(n-1, -1, -1)))\n\nlw = 0.05\ndef stack(n, size, l, top, bot):\n \"Feature map stack\"\n m = matrix(n, size, size).fill_color(Color(\"#dddddd\"))\n r = rectangle(size, size).fill_color(grey).line_width(lw)\n return (label(top) / (back(r, l) + m) / label(bot)).center_xy()\nstack(\"a\", 32, 0, \"\", \"\")\n\ndef network(n, size, top, bot):\n \"Draw a network layer\"\n return (label(top) / rectangle(2, size).fill_color(grey).line_width(lw).named(n) / label(bot)).center_xy()\n\n# The number 7\ndraw = make_path([(-10, -10), (10, -10 ), (-10, 10)]).line_width(0.09).line_color(blue).fill_opacity(0)\n\n# Draw the main diagram.\nh = hstrut(6.5)\nd = ((stack(\"a\", 32, 0, \"\", \"\") + draw) | (label(\"conv\") / h) |\n stack(\"b\", 28, 6, \"\", \"C1\") | (label(\"pool\") / h) |\n stack(\"c\", 14, 6, \"\", \"S2\") | (label(\"conv\") / h) |\n stack(\"d\", 10, 16, \"\", \"C3\") | (label(\"pool\") / h) | hstrut(-0.5) |\n stack(\"e\", 5, 16, \"\", \"S4\") | (label(\"dense\") / h) |\n network(\"dense1\", 12, \"\", \"\") | (label(\"dense\") / (h)) |\n network(\"dense2\", 8.4, \"\", \"\") | (label(\"dense\") / h) |\n network(\"dense3\", 1, \"\", \"\"))\n\nd = d.scale_uniform_to_x(5)\n\n# Draw the orange boxes\nboxes = [((\"a\", 2, 2), (\"a\", 6, 6)),\n ((\"b\", 2, 2), (\"b\", 2, 2)),\n ((\"b\", 20, 2), (\"b\", 23, 5)),\n ((\"c\", 10, 2), (\"c\", 11, 3)),\n ((\"c\", 4, 6), (\"c\", 8, 10)),\n ((\"d\", 4, 6), (\"d\", 4, 6)),\n ((\"d\", 6, 4), (\"d\", 9, 7)),\n ((\"e\", 3, 2), (\"e\", 4, 3))]\n\nd += concat([cover(d, *b).fill_color(papaya).fill_opacity(0.3).named((\"box\", i))\n for i, b in enumerate(boxes)])\n\nconnect = [((\"box\", i), (\"box\", i + 1)) for i in range(0, 6, 2)]\n\n\nfor b in connect:\n d = connect_all(d, *b)\n\nset_svg_height(300)\nd\n"
},
{
"path": "docs/examples/squares.py",
"content": "from PIL import Image as PILImage\nimport math\nimport random\n\nfrom itertools import product\n\nfrom colour import Color\nfrom chalk import square, concat, empty\n\nrandom.seed(0)\n\ndef make_square():\n colors = [\n Color(\"#ff9700\"), # papaya\n Color(\"#005FDB\"), # blue\n ]\n\n # generate uniformly a value in [-max_angle, max_angle]\n max_angle = math.pi / 24.0\n ΞΈ = 2 * max_angle * random.random() - max_angle\n\n # pick a random color\n i = random.random() > 0.75\n color = colors[i]\n\n return square(0.75).line_color(color).rotate_rad(-ΞΈ)\nmake_square()\n\ndef make_group(num_squares=4):\n return concat(make_square() for _ in range(num_squares))\nmake_group()\n\ndisps = range(4)\ndiagram = concat(make_group().translate(x, y) for x, y in product(disps, disps))\n\ndiagram = diagram.line_width(0.02)\ndiagram\n"
},
{
"path": "docs/examples/tensor.py",
"content": "from PIL import Image as PILImage\nfrom chalk import *\nfrom colour import Color\n\nh = hstrut(2.5)\npapaya = Color(\"#ff9700\")\nwhite = Color(\"white\")\nblack = Color(\"black\")\n\n\ndef draw_cube():\n # Assemble cube\n face_m = rectangle(1, 1).align_tl()\n face_t = rectangle(1, 0.5).shear_x(-1).align_bl()\n face_r = rectangle(0.5, 1).shear_y(-1).align_tr()\n cube = (face_t + face_m).align_tr() + face_r\n\n # Replace envelope with front face. \n return cube.align_bl().with_envelope(face_m.align_bl())\n\ndef draw_tensor(depth, rows, columns):\n \"Draw a tensor\"\n cube = draw_cube()\n # Fix this ...\n hyp = (unit_y * 0.5).shear_x(-1)\n # Build a matrix. \n front = cat([hcat([cube for i in range(columns)])\n for j in reversed(range(rows))], -unit_y).align_t()\n\n # Build depth\n return concat(front.translate(-k * hyp.x, -k * hyp.y)\n for k in reversed(range(depth)))\n\ndraw_tensor(2, 3, 4)\n\ndef t(d, r, c):\n return draw_tensor(d, r, c).fill_color(white)\n\ndef label(te, s=1.5):\n return (text(te, s).fill_color(black).line_color(white).center_xy())\n\n\n# Create a diagram.\nd, r, c = 3, 4, 5\nbase = t(d, r, c).line_color(papaya)\nm = hcat([t(1, r, c), t(d, 1, c), label(\"β\"), (base + t(1, r, c)), (base + t(d, 1, c) ), label(\"=\"), t(d, r, c)], sep=2.5).line_width(0.02)\nm\n"
},
{
"path": "docs/index.md",
"content": "---\nhide:\n - navigation\n - toc\n---\n--8<-- \"README.md\"\n"
},
{
"path": "docs/overrides/main.html",
"content": "{% extends \"base.html\" %}\n\n{% block content %}\n{{ super() }}\n\n\n{% endblock content %}\n\n \n"
},
{
"path": "docs/quickstart/.gitkeep",
"content": ""
},
{
"path": "examples/arrows.py",
"content": "from chalk import *\nfrom chalk.trail import Trail\nfrom colour import Color\nfrom PIL import Image as PILImage\n\ngrey = Color(\"grey\")\nblue = Color(\"blue\")\norange = Color(\"orange\")\n\noctagon = regular_polygon(8, 1.5).rotate_by(1 / 16).line_color(grey).line_width(0.5).show_origin()\ndias = octagon.named(\"first\") | hstrut(3) | octagon.named(\"second\")\n\nex1 = dias.connect(\n \"first\",\n \"second\",\n ArrowOpts(trail=Trail.from_offsets([unit_x, 0.25 * unit_y, unit_x, 0.25 * unit_y]))\n)\nex1\n\nex1 = dias.connect(\n \"first\",\n \"second\",\n ArrowOpts(\n head_style=Style.empty().fill_color(grey),\n arc_height=0.5,\n shaft_style=Style.empty().line_color(blue),\n ),\n)\nex1 = ex1.connect(\n \"second\",\n \"first\",\n ArrowOpts(\n head_style=Style.empty().fill_color(grey),\n arc_height=0.5,\n shaft_style=Style.empty().line_color(blue),\n ),\n)\n\nex12 = ex1.connect_perim(\n \"first\",\n \"second\",\n unit_x.rotate_by(15 / 16),\n unit_x.rotate_by(9 / 16),\n ArrowOpts(head_pad=0.1),\n)\nex3 = arrow_v(unit_y)\nd = ex12 + ex3\n\nd\n\noutput_path = \"examples/output/arrows.svg\"\nd.render_svg(output_path, height=200)\n\noutput_path = \"examples/output/arrows.png\"\nd.render(output_path, height=200)\n\nPILImage.open(output_path)\n\noutput_path = \"examples/output/arrows.pdf\"\nd.render_pdf(output_path, height=200)\n"
},
{
"path": "examples/bigben.py",
"content": "# # Big Ben\n\n# *A literate notebook by [Sasha Rush](http://www.rush-nlp.com)*\n\n# [Big Ben](https://en.wikipedia.org/wiki/Big_Ben) is the most iconic clock face in the world.\n\n# Dan OneaΘΔ and Alexander Rush .\n\n### Preview Controls\nuse_directory_urls: true\nstrict: false\ndev_addr: localhost:8000\n\n### Configuration\ndocs_dir: docs\n# watch a list of directories for changes\n# and automatically regenerate the docs\nwatch:\n - chalk\n\n### Theme\ntheme:\n name: material\n include_sidebar: true\n custom_dir: docs/overrides\n #custom_dir: overrides\n palette:\n - media: \"(prefers-color-scheme: light)\"\n scheme: default\n primary: white\n accent: amber\n # toggle:\n # # icon: material/lightbulb-outline\n # icon: material/toggle-switch-off-outline\n # name: Switch to dark mode\n # - media: \"(prefers-color-scheme: dark)\"\n # scheme: slate\n # primary: white\n # accent: amber\n # toggle:\n # # icon: material/lightbulb\n # icon: material/toggle-switch\n # name: Switch to light mode\n features:\n - content.code.annotate\n - content.tabs.link\n # - header.autohide\n # - navigation.expand\n - navigation.indexes # @regular\n - navigation.instant # @regular | enables \"instant-loading\"; good for a very large docs repo.\n - navigation.sections # @regular | extending top level sections.\n - navigation.tabs # @regular | enables showing toplevel sections as tabs (horizontal).\n - navigation.tabs.sticky # @regular | keeps the tabs visible even when you have scrolled down.\n - navigation.top # @regular | adds a \"back-to-top\" is shown after the user scrolls down and then starts to come back up again.\n - navigation.tracking # @insiders\n - search.highlight\n - search.share\n - search.suggest\n - toc.integrate: false # @regular | integrates the nav (on-left) with toc (on-right) and places the integrated nav+toc on-left.\n icon:\n # repo: fontawesome/brands/git-square\n repo: fontawesome/brands/git-alt\n # repo: fontawesome/brands/github\n # repo: fontawesome/brands/github-alt\n # repo: fontawesome/brands/github-square\n logo: logo.png # img/icon-white.svg\n # favicon: logo.png # img/favicon.png\n font:\n text: Roboto\n code: Roboto Mono # Source Code Pro, JetBrains Mono, Roboto Mono\n language: en\n\n### Plugins\nplugins:\n - exclude:\n glob:\n - '*/storage/*'\n - search:\n indexing: 'full' # 'full' (default), 'sections', 'titles'\n - autorefs\n - git-revision-date\n # macros must be placed after plugin: git-revision-date\n - macros:\n include_dir: docs/assets/snippets # snippets\n # j2_block_start_string: '{{%'\n # j2_block_end_string: '%}}'\n # j2_variable_start_string: '{{'\n # j2_variable_end_string: '}}'\n - markdownextradata:\n data: data\n - minify:\n minify_html: true\n # - social # @insiders\n - mkdocs-jupyter:\n include_source: true\n ignore_h1_titles: true\n execute: true\n - tooltips\n - mkdocstrings\n\n### Extensions\nmarkdown_extensions:\n # - abbr\n # - admonition\n # - attr_list\n # - codehilite\n # - def_list\n # - extra\n # - footnotes\n # - meta\n # - md_in_html\n # - smarty\n # - tables\n # - toc\n ##! Controls: markdown.extensions\n - markdown.extensions.abbr # same as: - abbr\n - markdown.extensions.admonition # same as: - admonition\n - markdown.extensions.attr_list # same as: - attr_list\n - markdown.extensions.codehilite: # same as: - codehilite\n guess_lang: false\n - markdown.extensions.def_list # same as: - def_list\n - markdown.extensions.extra # same as: - extra\n - markdown.extensions.footnotes # same as: - footnotes\n - markdown.extensions.meta: # same as: - meta\n - markdown.extensions.md_in_html # same as: - md_in_html\n - markdown.extensions.smarty: # same as: - smarty\n smart_quotes: false\n - markdown.extensions.tables # same as: - tables\n - markdown.extensions.toc: # same as: - toc\n slugify: !!python/name:pymdownx.slugs.uslugify\n permalink: true\n toc_depth: 6 # default: 6\n #separator: \"-\"\n\n - markdown_include.include:\n base_path: docs\n\n ##! Controls: mdx\n - mdx_include:\n base_path: docs\n - mdx_truly_sane_lists:\n nested_indent: 2\n truly_sane: true\n\n ##! Controls: pymdownx\n - pymdownx.arithmatex:\n generic: true\n # - pymdownx.b64:\n # base_path: '.'\n - pymdownx.betterem:\n smart_enable: all # default: 'underscore' ; options: 'underscore', 'all', 'asterisk', or 'none'\n - pymdownx.caret: # \"super^script^\" will render as superscript text: superscript .\n smart_insert: true # default: true\n insert: true # default: true\n superscript: true # default: true\n - pymdownx.critic\n - pymdownx.details\n - pymdownx.emoji:\n emoji_index: !!python/name:materialx.emoji.twemoji\n emoji_generator: !!python/name:materialx.emoji.to_svg\n - pymdownx.escapeall:\n hardbreak: false\n nbsp: false\n # Uncomment these 2 lines during development to more easily add highlights\n - pymdownx.highlight:\n use_pygments: true # this uses pygments\n linenums: false # Set \"linenums\" to true for enabling\n # code-block line-numbering\n # globally.\n # None: only enable line-numbering on a per code-block basis.\n # False: disable line-numbering globally.\n auto_title: false\n auto_title_map: {\n \"Python Console Session\": \"Python\", # lang: pycon\n }\n linenums_style: pymdownx-inline # table or pymdownx-inline\n - pymdownx.inlinehilite:\n custom_inline:\n - name: math\n class: arithmatex\n format: !!python/name:pymdownx.arithmatex.inline_mathjax_format\n - pymdownx.keys:\n separator: \"\\uff0b\"\n - pymdownx.magiclink:\n repo_url_shortener: true\n repo_url_shorthand: true #\n social_url_shorthand: true\n social_url_shortener: true\n user: !ENV REPO_OWNER # sugatoray, danoneata (github userid)\n repo: chalk #\n normalize_issue_symbols: true\n - pymdownx.mark:\n smart_mark: true\n - pymdownx.pathconverter:\n base_path: 'chalk' # default: ''\n relative_path: '' # default ''\n absolute: true # default: false\n tags: 'a script img link object embed'\n - pymdownx.progressbar:\n level_class: true\n add_classes: ''\n #'progress-0plus progress-10plus progress-20plus progress-30plus progress-40plus progress-50plus progress-60plus progress-70plus progress-80plus progress-90plus progress-100plus'\n progress_increment: 10\n - pymdownx.saneheaders\n - pymdownx.superfences:\n # highlight_code: true # This was removed from pymdownx v9.0\n preserve_tabs: false\n disable_indented_code_blocks: false # default: false | set this to \"true\"\n # if you only use fenced code-blocks.\n custom_fences:\n - name: mermaid\n class: mermaid\n format: !!python/name:pymdownx.superfences.fence_code_format ''\n - name: math\n class: arithmatex\n format: !!python/name:pymdownx.arithmatex.fence_mathjax_format\n # - name: md-render\n # class: md-render\n # format: !!python/name:tools.pymdownx_md_render.md_sub_render\n - pymdownx.smartsymbols\n - pymdownx.snippets:\n base_path:\n - '.'\n - './docs_src'\n - './LICENSE'\n - './README.md'\n - './doc' # [TODO: move the contents of this folder to the docs folder]\n encoding: 'utf-8' # Encoding to use when reading in the snippets.\n check_paths: true # Make the build fail if a snippet can't be found.\n - pymdownx.striphtml\n - pymdownx.tabbed\n - pymdownx.tasklist:\n custom_checkbox: true\n - pymdownx.tasklist:\n custom_checkbox: true\n - pymdownx.tilde # ~~text~~ will render as strikethrough text. \"sub~script\" will render as subscript text: subscript .\n\n\n### Customization\n# extra:\n # version:\n # default: latest\n # provider: mike\n # disqus: !ENV REPO_OWNER\n #alternate:\n #- name: en - English\n # link: /\n # lang: en\n\n\n\n### Extra CSS\nextra_css:\n ## for: termynal (terminal animation)\n - assets/css-js/termynal/css/termynal.css\n - assets/css-js/termynal/css/custom.css\n ## for: pymdownx.progressbar\n - assets/css-js/general/css/progressbar.css\n # - assets/css-js/pymdownx-extras/css/extra.css # (for striped progress bar)\n ## for: mkdocs-tooltips\n - assets/css-js/mkdocs-tooltips/css/hint.min.css\n - assets/css-js/mkdocs-tooltips/css/custom.css\n ## for: mkdocs-material using highlight.js\n - https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/styles/default.min.css\n ## for: fastapi like side-theme\n - assets/css-js/fastapi/custom.css\n\n\n### Extra JS\nextra_javascript:\n ## for: pymdownx.arithmatex\n - https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-MML-AM_CHTML\n ## for: markdown.extensions.tables\n - https://cdnjs.cloudflare.com/ajax/libs/tablesort/5.2.1/tablesort.min.js\n - assets/css-js/general/js/tables.js\n ## for: termynal (terminal animation)\n - assets/css-js/termynal/js/termynal.js\n - assets/css-js/termynal/js/custom.js\n # Set the environment variable \"FONTAWESOME_KIT\" with the value of the kit.\n - !ENV FONTAWESOME_KIT\n ## for: lottiefiles\n - https://unpkg.com/@lottiefiles/lottie-player@latest/dist/lottie-player.js\n ## for: mkdocs-material using highlight.js\n - https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/highlight.min.js\n - assets/css-js/general/js/highlight-config.js\n ## for: mkdocs-markmap\n - https://unpkg.com/d3@6.7.0/dist/d3.min.js\n - https://unpkg.com/markmap-lib@0.11.5/dist/browser/index.min.js\n - https://unpkg.com/markmap-view@0.2.6/dist/index.min.j\n ## Others\n - https://polyfill.io/v3/polyfill.min.js?features=es6\n # - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js\n ## for: fastapi like side-theme\n - assets/css-js/fastapi/custom.js\n - assets/css-js/fastapi/chat.js\n\n### Pages: Navigation\n\n## @@ Begin NAVIGATION\nnav:\n - Home: index.md\n - API:\n - Shapes: api/shapes.py\n - Alignment: api/alignment.py\n - Combinators: api/combinators.py\n - Transformations: api/transformations.py\n - Style: api/style.py\n - Rendering: api/rendering.py\n - Trails: api/trails.py\n - Connections: api/names.py\n - Utils: api/utils.md\n - Internals: api/internals.md\n - Examples:\n - BigBen: examples/bigben.py\n - Hanoi: examples/hanoi.py\n - Koch: examples/koch.py\n - LeNet: examples/lenet.py\n - Squares: examples/squares.py\n - Tensor: examples/tensor.py\n - Tree: examples/tree.py\n - About:\n - about/index.md\n - License: about/license.md\n\n## @@ End NAVIGATION\n"
},
{
"path": "pyproject.toml",
"content": "[build-system]\nrequires = [\n \"setuptools\",\n \"wheel\"\n]\n\nbuild-backend = \"setuptools.build_meta\"\n"
},
{
"path": "requirements/dev.txt",
"content": "flake8>=3.6.0\nblack>=19.3b0\nmypy>=0.95\ninterrogate>=1.5.0\nisort>=5.10.0\ndarglint>=1.8.0\npre-commit>=2.2.0\n# flake8-print>=4.4.0\npytest>=4.0.2\nhypothesis\n"
},
{
"path": "requirements/docs.txt",
"content": "mkdocs\nmkdocs-material==8.1.3\nmkdocs-material-extensions>=1.0.3\npymdown-extensions>=9.0\nmdx-include>=1.4.1\nmarkdown-include>=0.6.0\nmdx_truly_sane_lists>=1.2\npygments\njupyter\n\n## Navigation & page building\n# source: https://github.com/mkdocs/mkdocs/wiki/MkDocs-Plugins#navigation--page-building\nmkdocs-exclude>=1.0.2\nmkdocs-awesome-pages-plugin>=2.5.0\nmkdocs-markdownextradata-plugin>=0.2.4\n\n\n## Links & references\n# source: https://github.com/mkdocs/mkdocs/wiki/MkDocs-Plugins#links--references\nmkdocs-redirects>=1.0.3\nmkdocs-tooltipster-links-plugin>=0.1.0\n\n\n## HTML processing & CSS styling\n# source: https://github.com/mkdocs/mkdocs/wiki/MkDocs-Plugins#html-processing--css-styling\nmkdocs-minify-plugin>=0.4.1\nmkdocs-enumerate-headings-plugin>=0.4.5\n\n\n## API documentation building\nmkapi\nmkautodoc\nmkdocstrings[python]>=0.16.2\nmkdocs-gen-files>=0.3.3\nmkdocs-autorefs>=0.3.1\n\n\n## Citations & bibliography\n# source: https://github.com/mkdocs/mkdocs/wiki/MkDocs-Plugins#citations--bibliography\nmkdocs-bibtex>=1.0.0\n\n\n## Code execution, variables & templating\n# source: https://github.com/mkdocs/mkdocs/wiki/MkDocs-Plugins#code-execution-variables--templating\npydoc-markdown>=4.6.3\nmkdocs-jupyter>=0.18.2\nmkdocs-markdownextradata-plugin>=0.2.4\nmkdocs-markmap>=2.1.2\n\n\n## Git repos and info\n# source: https://github.com/mkdocs/mkdocs/wiki/MkDocs-Plugins#git-repos--info\nmkdocs-macros-plugin>=0.6.0\nmkdocs-git-revision-date-plugin>=0.3.1\n\n\n## Images, Tables, Charts & Graphs\n# source: https://github.com/mkdocs/mkdocs/wiki/MkDocs-Plugins#images-tables-charts--graphs\nmkdocs-kroki-plugin>=0.2.0\nmkdocs-drawio-exporter>=0.8.0\nmkdocs-table-reader-plugin>=0.6\n\n\n## PDF & site conversion\n# source: https://github.com/mkdocs/mkdocs/wiki/MkDocs-Plugins#pdf--site-conversion\n# https://doc.courtbouillon.org/weasyprint/latest/first_steps.html#linux\nmkdocs-pdf-export-plugin>=0.5.9\n\n\n## Other\n# source: https://github.com/mkdocs/mkdocs/wiki/MkDocs-Plugins#other\nmkdocs-tooltips>=0.1.0\nmkdocs-coverage>=0.2.4\n\n\n## Reusing content, snippets & includes\n# source: https://github.com/mkdocs/mkdocs/wiki/MkDocs-Plugins#reusing-content-snippets--includes\nmkdocs-include-markdown-plugin>=3.2.3\n"
},
{
"path": "requirements.txt",
"content": "toolz\ncolour\nsvgwrite\ncairosvg\nPillow\ngit+https://github.com/chalk-diagrams/planar\nlatextools\nloguru\ntyping-extensions\nimportlib-metadata\n"
},
{
"path": "setup.cfg",
"content": "[bdist_wheel]\n# what is this for?\n# - https://packaging.python.org/en/latest/guides/distributing-packages-using-setuptools/#wheels\nuniversal=0\n\n[metadata]\nlicense_file = LICENSE\n\n[black]\nline-length = 79\n# exclude = '''\n# /(\n# \\.archive\n# | \\.git\n# | \\.hg\n# | \\.mypy_cache\n# | \\.tox\n# | \\.venv\n# | \\.vscode\n# | _build\n# | buck-out\n# | build\n# | dist\n# | migrations\n# | site\n# )/\n# '''\n\n[isort]\n# make it compatible with black\nprofile = black\n# # Make sure this matches `*.py` in .editorconfig\n# ensure_newline_before_comments = true\n# force_single_line = true\n# lines_after_imports = 3\n# include_trailing_comma = true\n# use_parentheses = true\n\n[flake8]\nper-file-ignores=chalk/__init__.py: F401\nmax-line-length = 88\nextend-ignore = E203\n\n[darglint]\n##? Source: https://github.com/terrencepreilly/darglint\n## Ignore properties\nignore_properties = 1\n## Ignore private methods\nignore_regex = ^_(.*)\n## Use message template\n# message_template = {msg_id}@{path}:{line}\n## Docstring style to use:\n# - google (default)\n# - sphinx\n# - numpy\ndocstring_style = google\n## How strict?\n# short: One-line descriptions are acceptable; anything\n# more and the docstring will be fully checked.\n#\n# long: One-line descriptions and descriptions without\n# arguments/returns/yields/etc. sections will be\n# allowed. Anything more, and the docstring will\n# be fully checked.\n#\n# full: (Default) Docstrings will be fully checked.\nstrictness = long\n## Ignore common exceptions\n# ignore_raise = ValueError,MyCustomError\n## Ignore Specific Error Codes\n# Example: ignore = DAR402,DAR103\n#------------------------------------------------------------------------\n# DAR001 # The docstring was not parsed correctly due to a syntax error.\n# DAR002 # An argument/exception lacks a description\n# DAR003 # A line is under-indented or over-indented.\n# DAR004 # The docstring contains an extra newline where it shouldn't.\n# DAR005 # The item contains a type section (parentheses), but no type.\n# DAR101 # The docstring is missing a parameter in the definition.\n# DAR102 # The docstring contains a parameter not in function.\n# DAR103 # The docstring parameter type doesn't match function.\n# DAR104 # (disabled) The docstring parameter has no type specified\n# DAR105 # The docstring parameter type is malformed.\n# DAR201 # The docstring is missing a return from definition.\n# DAR202 # The docstring has a return not in definition.\n# DAR203 # The docstring parameter type doesn't match function.\n# DAR301 # The docstring is missing a yield present in definition.\n# DAR302 # The docstring has a yield not in definition.\n# DAR401 # The docstring is missing an exception raised.\n# DAR402 # The docstring describes an exception not explicitly raised.\n# DAR501 # The docstring describes a variable which is not defined.\n#------------------------------------------------------------------------\nignore = DAR103\n\n[mypy]\nstrict = true\nwarn_unreachable = true\npretty = true\nshow_column_numbers = true\nshow_error_codes = true\nshow_error_context = true\n\n[mypy-chalk]\nimplicit_reexport = true\n[mypy-chalk.shapes]\nimplicit_reexport = true"
},
{
"path": "setup.py",
"content": "import pathlib\n\nfrom setuptools import find_packages, setup\n\nLICENSE: str = \"MIT\"\nREADME: str = pathlib.Path(\"README.md\").read_text(encoding=\"utf-8\")\n\n# ---------------------------------------------------------------\n# NOTE:\n# Since the library name (chalk-diagrams) is different from\n# the module (chalk), we set the custom dunder attribute\n# __libname__ in chalk/__init__.py and use it there to fetch\n# and set __version__ with library metadata inside\n# chalk/__init__.py.\n# Since, library name will not be changed in future, it is\n# being maintained at two places\n# 1. setup.py\n# 1. chalk/__init__.py\n#\n# The version will be updated often only from setup.py.\n# ---------------------------------------------------------------\nLIBNAME: str = \"chalk-diagrams\"\n\nsetup(\n name=LIBNAME,\n version=\"0.2.2\",\n packages=find_packages(\n include=[\"chalk\", \"chalk*\"],\n exclude=[\"examples\", \"docs\", \"test*\"],\n ),\n description=\"A declarative drawing API\",\n install_requires=[\n \"toolz\",\n \"colour\",\n \"svgwrite\",\n \"Pillow\",\n \"loguru\",\n \"chalk-planar\",\n \"typing-extensions\",\n \"importlib-metadata\",\n ],\n extras_require={\n \"tikz\": [\"pylatex\"],\n \"latex\": [\"latextools\"],\n \"png\": [\"pycairo\"],\n \"svg\": [\"cairosvg\"],\n },\n long_description=README,\n long_description_content_type=\"text/markdown\",\n author=\"Dan OneaΘΔ\",\n author_email=\"dan.oneata@gmail.com\",\n url=\"https://github.com/chalk-diagrams/chalk\",\n project_urls={\n \"Documentation\": \"https://chalk-diagrams.github.io\",\n \"Source Code\": \"https://github.com/chalk-diagrams/chalk\",\n \"Issue Tracker\": \"https://github.com/chalk-diagrams/chalk/issues\",\n },\n license=LICENSE,\n license_files=(\"LICENSE\",),\n classifiers=[\n \"Intended Audience :: Science/Research\",\n \"Operating System :: OS Independent\",\n \"Programming Language :: Python :: 3\",\n \"Programming Language :: Python :: 3.7\",\n \"Programming Language :: Python :: 3.8\",\n \"Programming Language :: Python :: 3.9\",\n f\"License :: OSI Approved :: {LICENSE} License\",\n \"Topic :: Scientific/Engineering\",\n ],\n)\n"
},
{
"path": "tests/test_envelope.py",
"content": "import math\n\nimport pytest\nfrom hypothesis import given\nfrom hypothesis.strategies import (\n DrawFn,\n composite,\n integers,\n lists,\n one_of,\n sampled_from,\n)\n\nimport chalk\nfrom chalk import (\n P2,\n V2,\n Diagram,\n Trail,\n circle,\n empty,\n make_path,\n origin,\n rectangle,\n unit_x,\n unit_y,\n)\n\n\n@composite\ndef vectors(draw: DrawFn) -> V2:\n x = draw(integers(min_value=-2, max_value=2).filter(lambda x: x != 0))\n y = draw(integers(min_value=-2, max_value=2).filter(lambda x: x != 0))\n return V2(x, y)\n\n\nsmall_nat = integers(min_value=1, max_value=10)\n\n\n@composite\ndef trails(draw: DrawFn) -> Trail:\n vs = draw(lists(vectors(), min_size=1))\n return Trail.from_offsets(vs)\n\n\n@composite\ndef paths(draw: DrawFn) -> Diagram:\n return draw(trails()).stroke().center_xy()\n\n\n@composite\ndef circles(draw: DrawFn) -> Diagram:\n return circle(draw(small_nat))\n\n\n@composite\ndef rects(draw: DrawFn) -> Diagram:\n return rectangle(draw(small_nat), draw(small_nat))\n\n\n@composite\ndef shapes(draw: DrawFn) -> Diagram:\n return draw(one_of(paths(), rects(), circles()))\n\n\n@composite\ndef diagrams(draw: DrawFn) -> Diagram:\n shape = empty()\n for j in range(3):\n lshape = draw(shapes())\n shape += chalk.transform.apply_affine(draw(transforms()), lshape)\n return shape\n\n\n@composite\ndef transforms(draw: DrawFn) -> chalk.transform.Affine:\n v2 = draw(vectors())\n return draw(\n sampled_from(\n [\n chalk.transform.Affine.scale(v2),\n chalk.transform.Affine.translation(v2),\n chalk.transform.Affine.rotation(v2.angle),\n ]\n )\n )\n\n\n@given(diagrams(), vectors())\ndef test_envelope_trail(diagram: Diagram, vec: V2) -> None:\n \"Property -> Envelope bounds trace.\"\n trace = diagram.get_trace()\n env = diagram.get_envelope()\n ts = trace(P2(0, 0), vec)\n e = env(vec)\n for t in ts:\n assert e == pytest.approx(t) or e > t\n\n\n@given(diagrams(), vectors())\ndef test_pad(diagram: Diagram, vec: V2) -> None:\n orig = diagram.get_envelope()(vec)\n p = diagram.pad(2)\n assert p.get_envelope()(vec) == pytest.approx(2 * orig)\n vec = vec.normalized()\n orig = diagram.get_envelope()(vec)\n f = diagram.frame(2)\n assert f.get_envelope()(vec) == pytest.approx(2 + orig)\n\n\n# Some specific tests.\ndef test_square() -> None:\n square = make_path([(0, 0), (1, 0), (1, 1), (0, 1), (0, 0)])\n env = square.get_envelope()\n assert env(unit_x) == 1\n assert env(2 * unit_x) == 0.5\n assert env(unit_y) == 1\n assert env((unit_x + unit_y).normalized()) == pytest.approx(\n math.sqrt(1 + 1)\n )\n\n\ndef test_circle() -> None:\n d = circle(1)\n env = d.get_envelope()\n assert env(unit_x) == 1\n assert env(2 * unit_x) == 0.5\n assert env(unit_y) == 1\n assert env((unit_x + unit_y).normalized()) == pytest.approx(1)\n\n\ndef test_circle_trace() -> None:\n d = circle(1)\n trace = d.get_trace()\n assert set(trace(origin, unit_x)) == set([-1.0, 1.0])\n assert set(trace(origin, (2 * unit_x))) == set([-0.5, 0.5])\n assert set(trace(origin, unit_y)) == set([-1.0, 1.0])\n trace(origin, (unit_x + unit_y))\n\n\ndef test_path_trace() -> None:\n d = make_path([(1, 0), (1, 1)])\n trace = d.get_trace()\n assert trace.trace_v(origin, (unit_x + unit_y)) == V2(1.0, 1.0)\n assert trace.trace_v(origin, (unit_x + unit_y).normalized()) == V2(\n 1.0, 1.0\n )\n\n\ndef test_transform() -> None:\n square = make_path([(0, 0), (1, 0), (1, 1), (0, 1), (0, 0)])\n env = square.scale_x(2).scale_y(3).get_envelope()\n assert env(unit_x) == 2\n assert env(2 * unit_x) == 1\n assert env(unit_y) == 3\n env = square.rotate(45).get_envelope()\n assert env((unit_x + unit_y).normalized()) == pytest.approx(1)\n env = square.translate(-2, -2).get_envelope()\n assert env(unit_x) == pytest.approx(-1)\n"
},
{
"path": "tests/test_reverse_trail.py",
"content": "from hypothesis import given\nfrom hypothesis.strategies import (\n DrawFn,\n composite,\n integers,\n one_of,\n sampled_from,\n)\n\nimport chalk\nfrom chalk import V2, Trail, unit_x\nfrom chalk.shapes.arc import arc_seg_angle\nfrom chalk.shapes.segment import seg\n\n\n@composite\ndef vectors(draw: DrawFn) -> V2:\n x = draw(integers(-2, 2))\n y = draw(integers(-2, 2))\n return V2(x, y)\n\n\n@composite\ndef transforms(draw: DrawFn) -> chalk.transform.Affine:\n v2 = draw(vectors())\n return draw(\n sampled_from(\n [\n chalk.transform.Affine.scale(unit_x),\n chalk.transform.Affine.scale(v2),\n chalk.transform.Affine.translation(v2),\n chalk.transform.Affine.rotation(v2.angle),\n ]\n )\n )\n\n\n@composite\ndef segment(draw: DrawFn) -> Trail:\n dx = draw(integers())\n dy = draw(integers())\n return seg(V2(dx, dy))\n\n\n@composite\ndef arc(draw: DrawFn) -> Trail:\n angle = draw(integers(-360, 360))\n dangle = draw(integers(0, 360))\n return arc_seg_angle(angle, dangle)\n\n\nsmall_nat = integers(min_value=1, max_value=10)\n\n\n@composite\ndef trails(draw: DrawFn) -> Trail:\n parts = (\n draw(one_of(segment(), arc())).apply_transform(draw(transforms()))\n for _ in range(draw(small_nat))\n )\n return sum(parts, Trail.empty())\n\n\n@given(trails())\ndef test_involution(t: Trail) -> None:\n \"Reverse should be an involution.\"\n assert t.reverse().reverse() == t\n\n\n@given(trails(), trails())\ndef test_order(t1: Trail, t2: Trail) -> None:\n assert (t1 + t2).reverse() == t2.reverse() + t1.reverse()\n\n\n# Other possible tests?\n# - End point of reversed trail should correspond to start point of original\n# trail (and vicevers);\n# - The shape of the trail is preserved.\n"
}
] ![](\"https://raw.githubusercontent.com/chalk-diagrams/chalk/master/examples/output/logo-sm.png\"){kind=logo}
![](\"https://raw.githubusercontent.com/chalk-diagrams/chalk/master/doc/imgs/squares.png\")
![](\"https://raw.githubusercontent.com/chalk-diagrams/chalk/master/doc/imgs/logo.png\"){kind=logo}
![](\"https://raw.githubusercontent.com/chalk-diagrams/chalk/master/doc/imgs/escher-square-limit.png\")
![](\"https://raw.githubusercontent.com/chalk-diagrams/chalk/master/doc/imgs/hilbert.png\")
![](\"https://raw.githubusercontent.com/chalk-diagrams/chalk/master/doc/imgs/koch.png\")
![](\"https://raw.githubusercontent.com/chalk-diagrams/chalk/master/doc/imgs/hex-variation.png\")
![](\"https://raw.githubusercontent.com/chalk-diagrams/chalk/master/doc/imgs/lenet.png\")
![](\"https://raw.githubusercontent.com/chalk-diagrams/chalk/master/doc/imgs/tensor.png\")
![](\"https://raw.githubusercontent.com/chalk-diagrams/chalk/master/doc/imgs/hanoi.png\")
![](\"https://raw.githubusercontent.com/chalk-diagrams/chalk/master/doc/imgs/tree.png\")
![](\"https://raw.githubusercontent.com/chalk-diagrams/chalk/master/doc/imgs/lattice.png\")
![](\"https://user-images.githubusercontent.com/819256/184515950-b3ce4245-19ee-4357-bc3a-f32f993b04ef.png\")
\n"
},
{
"path": "docs/api/names.py",
"content": "# + tags=[\"hide_inp\"]\nfrom colour import Color\nfrom chalk.core import BaseDiagram\nfrom chalk import *\n\ndef help(f):\n import pydoc\n from IPython.display import HTML\n return HTML(pydoc.HTMLDoc().docroutine(f))\n\nset_svg_height(100)\n# -\n\n# Chalk supports basic methods for complex connected layouts and diagrams.\n# Individual elements can be assigned names, and then be referenced in their subdiagram locations.\n# As we will see, names are particularly useful for connecting different parts of the diagram with arrows.\n# Our implementation follows the API of the Haskell [diagrams](https://diagrams.github.io/doc/manual.html#named-subdiagrams) library,\n# but named nodes are also common in TikZ.\n#\n# ### Diagram.named\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.named)\n# -\n\ndiagram = circle(0.5).named(\"x\") | square(1)\ndiagram\n\n# ### Diagram.get_subdiagram\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.get_subdiagram)\n# -\n\n# A `Subdiagram` is a `Diagram` paired with its enclosing context (a `Transformation` for the moment; but `Style` should also be added at some point).\n# It has the following methods:\n# - `get_envelope`, which returns the corresponding `Envelope`\n# - `get_trace`, which returns the corresponding `Trace`\n# - `get_location`, which returns the local origin of the `Subdiagram`\n# - `boundary_from`, which return the furthest point on the boundary of the `Subdiagram`, starting from the local origin of the `Subdigram` and going in the direction of a given vector.\n\n#\n\ndiagram = circle(0.5).named(\"x\") | square(1)\nsub = diagram.get_subdiagram(\"x\")\ndiagram + circle(0.2).translate_by(sub.get_location())\n\n# ### Diagram.with_names\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.with_names)\n# -\n\nroot = circle(1).named(\"root\")\nleaves = hcat([circle(1).named(c) for c in \"abcde\"], sep=0.5).center()\n\ndef connect(subs, nodes):\n root, leaf = subs\n pp = tuple(root.boundary_from(unit_y))\n pc = tuple(leaf.boundary_from(-unit_y))\n return nodes + make_path([pp, pc])\n\nnodes = root / vstrut(2) / leaves\n\nfor c in \"abcde\":\n nodes = nodes.with_names([\"root\", c], connect)\nnodes\n\n# ### Diagram.qualify\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.qualify)\n# -\n\nred = Color(\"red\")\n\ndef attach(subs, dia):\n sub1, sub2 = subs\n p1 = tuple(sub1.get_location())\n p2 = tuple(sub2.get_location())\n return dia + make_path([p1, p2]).line_color(red)\n\n\ndef squares():\n s = square(1)\n return (\n (s.named(\"NW\") | s.named(\"NE\")) /\n (s.named(\"SW\") | s.named(\"SE\")))\n\n\ndia = hcat([squares().qualify(str(i)) for i in range(5)], sep=0.5)\npairs = [\n ((\"0\", \"NE\"), (\"2\", \"SW\")),\n ((\"1\", \"SE\"), (\"4\", \"NE\")),\n ((\"3\", \"NW\"), (\"3\", \"SE\")),\n ((\"0\", \"SE\"), (\"1\", \"NW\")),\n]\n\ndia\n\nfor pair in pairs:\n dia = dia.with_names(pair, attach)\n\ndia\n\n# ### Diagram.show_labels\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.show_labels)\n# -\n\ndia.show_labels(font_size=0.2)\n\n# ### Diagram.connect\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.connect)\n# -\n\ndiagram = circle(0.5).named(\"x\") | hstrut(1) | square(1).named(\"y\")\ndiagram.connect(\"x\", \"y\")\n\n# ### Diagram.connect_outside\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.connect_outside)\n# -\n\ndiagram = circle(0.5).named(\"x\") | hstrut(1) | square(1).named(\"y\")\ndiagram.connect_outside(\"x\", \"y\")\n"
},
{
"path": "docs/api/rendering.py",
"content": "# + tags=[\"hide\"]\nimport math\n\nfrom chalk.core import BaseDiagram\nfrom chalk import *\n\ndef help(f):\n import pydoc\n from IPython.display import HTML\n return HTML(pydoc.HTMLDoc().docroutine(f))\n# -\n\n# Chalk supports three back-ends (Cairo, SVG, TikZ),\n# which allow the created `Diagram`s to be rendered as PNG, SVG, PDF files, respectively.\n# The three corresponding methods for rendering are: `render`, `render_svg`, `render_pdf`;\n# these are documented below.\n#\n# ### Diagram.render\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.render)\n# -\n\ncircle(1).render(\"circle.png\")\nfrom IPython.display import Image\nImage(\"circle.png\")\n\n# ### Diagram.render_svg\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.render_svg)\n# -\n\n# ### Diagram.render_pdf\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.render_pdf)\n# -\n\n# ### ``Diagram``s in IPython notebooks\n\n# When a ``Diagram`` is used in an IPython notebook, it is automatically displayed as an SVG.\n# To adjust the height of the generated image, one can use the `set_svg_height` function:\n\n# + tags=[\"hide_inp\"]\nhelp(set_svg_height)\n# -\n\n# This function is particularly useful for showing tall drawings:\n\nset_svg_height(500)\nvcat([circle(1) for _ in range(5)])\n"
},
{
"path": "docs/api/shapes.py",
"content": "# + tags=[\"hide\"]\nfrom chalk.core import BaseDiagram\nfrom chalk import *\n\n\ndef help(f):\n import pydoc\n from IPython.display import HTML\n\n return HTML(pydoc.HTMLDoc().docroutine(f))\n\n# -\n\n# Elementary diagrams can be created using shapes: polygons, circle-like shapes, text and paths.\n\n# ## Polygons\n\n# ### Triangle\n\n# + tags=[\"hide_inp\"]\nhelp(triangle)\n# -\n\ntriangle(1)\n\n# ### Square and rectangle\n\n# + tags=[\"hide_inp\"]\nhelp(square)\n# -\n\nsquare(1)\n\n# + tags=[\"hide_inp\"]\nhelp(rectangle)\n# -\n\nrectangle(3, 1, 0.0)\n\n# ### Regular polygon\n\n# + tags=[\"hide_inp\"]\nhelp(regular_polygon)\n# -\n\nhcat(\n [\n regular_polygon(5, 1),\n regular_polygon(6, 1),\n regular_polygon(7, 1),\n ],\n sep=0.5,\n)\n\n# ## Circle-like shapes\n\n# ### Circle\n\n# + tags=[\"hide_inp\"]\nhelp(circle)\n# -\n\ncircle(1)\n\n# ### Arc\n\n# Arcs can be specified either using angles (see ``arc``) or points (see ``arc_between``).\n\n# + tags=[\"hide_inp\"]\nhelp(arc)\n# -\n\nquarter = 90\narc(1, 0, quarter)\n\narc(1, 0, quarter) + arc(1, 2 * quarter, 3 * quarter)\n\n# + tags=[\"hide_inp\"]\nhelp(arc_between)\n# -\n\narc_between((0, 0), (1, 0), 1)\n\n# ## Text\n\n# + tags=[\"hide_inp\"]\nhelp(text)\n# -\n\n# Note that unlike other shapes, ``text`` has an empty envelope, so we need to explicitly specify it in order to get a non-empty rendering.\n\ntext(\"hello\", 1).with_envelope(rectangle(2.5, 1))\n\n# ## Paths\n\n# + tags=[\"hide_inp\"]\nhelp(make_path)\n# -\n\nmake_path([(0, 0), (0, 1), (1, 1), (1, 2)])\n"
},
{
"path": "docs/api/style.py",
"content": "# + tags=[\"hide_inp\"]\nfrom chalk.core import BaseDiagram\nfrom chalk import *\n\ndef help(f):\n import pydoc\n from IPython.display import HTML\n return HTML(pydoc.HTMLDoc().docroutine(f))\n# -\n\n\n# Diagrams can be styled using standard vector graphic style\n# primitives. Colors use the Python [colour](https://github.com/vaab/colour) library.\n\nfrom colour import Color\nblue = Color(\"blue\")\norange = Color(\"orange\")\n\n# ### Diagram.fill_color\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.fill_color)\n# -\n\n#\n\ntriangle(1).fill_color(blue)\n\n# ### Diagram.fill_opacity\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.fill_opacity)\n# -\n\n#\n\ntriangle(1).fill_color(blue).fill_opacity(0.2)\n\n\n# ### Diagram.line_color\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.line_color)\n# -\n\n#\n\ntriangle(1).line_color(blue)\n\n# ### Diagram.line_width\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.line_width)\n# -\n\n#\n\ntriangle(1).line_width(0.05)\n\n\n# ### Diagram.dashing\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.dashing)\n# -\n\n#\n\ntriangle(1).dashing([0.2, 0.1], 0) \n\n\n# ### Advanced Example\n\n\n# Example: Outer styles override inner styles\n\n(triangle(1).fill_color(orange) | square(2)).fill_color(blue)\n"
},
{
"path": "docs/api/trails.py",
"content": "# + tags=[\"hide_inp\"]\nimport math\nfrom chalk import *\nfrom planar import Vec2Array\ndef help(f):\n import pydoc\n from IPython.display import HTML\n return HTML(pydoc.HTMLDoc().docroutine(f))\n# -\n\n# Chalk also includes a ``Trail`` primitive which allows for creating new ``Diagram``s and more complex shapes.\n# ``Trail``s are specified by position-invariant offsets and can be rendered as ``Path``s.\n# See the [Koch](../examples/koch/) example for a use case. \n\n# ### Constructors\n\n# ``Trail``s are a sequence of vectors and can be constructed using the ``from_offsets`` method:\n\ntrail = Trail.from_offsets([V2(1, 0), V2(1, 1), V2(0, 1)])\n\n# ### Converting to ``Diagram``\n\n# In order to render, `Trail`s have to be turned into ``Diagram``s, which can be achieved using the `stroke` method.\n\n# + tags=[\"hide_inp\"]\nhelp(Trail.stroke)\n# -\n\ntrail.stroke()\n\n# ### Transformations\n\n# `Trail`s can be transformed using the usual geometric transformations, which are also applied to the ``Diagram`` object.\n# For example, ``Trail``s can be rotated:\n\n# + tags=[\"hide_inp\"]\nhelp(Trail.rotate_by)\n# -\n\ntrail2 = trail.rotate_by(0.2)\ntrail2.stroke()\n\n# However, since `Trail`s are translation invariant, applying the `translate` method leaves the `Trail` instance unchanged.\n\n# ### Composition\n\n# ``Trail``s form a monoid with addition given by list concatenation and identity given by the empty list.\n# Intuitively, adding two ``Trails`` appends the two sequences of offsets.\n\n# + tags=[\"hide_inp\"]\nhelp(Trail.__add__)\n# -\n\n(trail + trail2).stroke()\n"
},
{
"path": "docs/api/transformations.py",
"content": "# + tags=[\"hide_inp\"]\nfrom chalk.core import BaseDiagram\nfrom chalk import *\n\ndef help(f):\n import pydoc\n from IPython.display import HTML\n return HTML(pydoc.HTMLDoc().docroutine(f))\n# -\n\n\n# Any Diagram (or other object in Chalk) can be transformed by affine transformation.\n# These produce a new diagram in the standard manner.\n\n# ### scale\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.scale)\n# -\n\n#\n\ntriangle(1) | triangle(1).scale(2)\n\n# Transformations apply to the whole diagram.\n\n(triangle(1) | triangle(1)).scale(2)\n\n\n# ### translate\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.translate)\n# -\n\n#\n\ntriangle(1).translate(1, 1).show_envelope().show_origin()\n\n#\n\ntriangle(1) + triangle(1).translate(1, 1)\n\n# ### shear_x\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.shear_x)\n# -\n\n#\n\nsquare(1).shear_x(0.25).show_envelope()\n\n#\n\nsquare(1) | square(1).shear_x(0.25)\n\n# ### rotate\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.rotate)\n# -\n\n#\n\ntriangle(1) | triangle(1).rotate(90)\n\n# ### rotate_by\n\n# + tags=[\"hide_inp\"]\nhelp(BaseDiagram.rotate_by)\n# -\n\n#\n\ntriangle(1) | triangle(1).rotate_by(0.2)\n"
},
{
"path": "docs/api/utils.md",
"content": "---\ntitle: chalk.utils\n---\n# **`{{ title }}`**\n\nπ\n\n::: {{ title }}\n"
},
{
"path": "docs/assets/css-js/as-fastapi/chat.js",
"content": "((window.gitter = {}).chat = {}).options = {\n room: 'tiangolo/fastapi'\n};\n"
},
{
"path": "docs/assets/css-js/as-fastapi/custom.css",
"content": "/* source: https: //github.com/tiangolo/fastapi/blob/1876ebc77949a9a254909ec61ea0c09365169ec2/docs/en/docs/css/custom.css */\n\n.termynal-comment {\n color: #4a968f;\n font-style: italic;\n display: block;\n}\n\n.termy [data-termynal] {\n white-space: pre-wrap;\n}\n\na.external-link::after {\n /* \\00A0 is a non-breaking space\n to make the mark be on the same line as the link\n */\n content: \"\\00A0[βͺ]\";\n}\n\na.internal-link::after {\n /* \\00A0 is a non-breaking space\n to make the mark be on the same line as the link\n */\n content: \"\\00A0βͺ\";\n}\n\n.shadow {\n box-shadow: 5px 5px 10px #999;\n}\n\n/* Give space to lower icons so Gitter chat doesn't get on top of them */\n.md-footer-meta {\n padding-bottom: 2em;\n}\n\n.user-list {\n display: flex;\n flex-wrap: wrap;\n margin-bottom: 2rem;\n}\n\n.user-list-center {\n justify-content: space-evenly;\n}\n\n.user {\n margin: 1em;\n min-width: 7em;\n}\n\n.user .avatar-wrapper {\n width: 80px;\n height: 80px;\n margin: 10px auto;\n overflow: hidden;\n border-radius: 50%;\n position: relative;\n}\n\n.user .avatar-wrapper img {\n position: absolute;\n top: 50%;\n left: 50%;\n transform: translate(-50%, -50%);\n}\n\n.user .title {\n text-align: center;\n}\n\n.user .count {\n font-size: 80%;\n text-align: center;\n}\n\na.announce-link:link,\na.announce-link:visited {\n color: #fff;\n}\n\na.announce-link:hover {\n color: var(--md-accent-fg-color);\n}\n\n.announce-wrapper {\n display: flex;\n justify-content: space-between;\n flex-wrap: wrap;\n align-items: center;\n}\n\n.announce-wrapper div.item {\n display: none;\n}\n\n.announce-wrapper .sponsor-badge {\n display: block;\n position: absolute;\n top: -5px;\n right: 0;\n font-size: 0.5rem;\n color: #999;\n background-color: #666;\n border-radius: 10px;\n padding: 0 10px;\n z-index: 10;\n}\n\n.announce-wrapper .sponsor-image {\n display: block;\n border-radius: 20px;\n}\n\n.announce-wrapper>div {\n min-height: 40px;\n display: flex;\n align-items: center;\n}\n\n.twitter {\n color: #00acee;\n}\n"
},
{
"path": "docs/assets/css-js/as-fastapi/custom.js",
"content": "// source: https://github.com/tiangolo/fastapi/blob/1876ebc77949a9a254909ec61ea0c09365169ec2/docs/en/docs/js/custom.js\n\nconst div = document.querySelector('.github-topic-projects')\n\nasync function getDataBatch(page) {\n const response = await fetch(`https://api.github.com/search/repositories?q=topic:fastapi&per_page=100&page=${page}`, { headers: { Accept: 'application/vnd.github.mercy-preview+json' } })\n const data = await response.json()\n return data\n}\n\nasync function getData() {\n let page = 1\n let data = []\n let dataBatch = await getDataBatch(page)\n data = data.concat(dataBatch.items)\n const totalCount = dataBatch.total_count\n while (data.length < totalCount) {\n page += 1\n dataBatch = await getDataBatch(page)\n data = data.concat(dataBatch.items)\n }\n return data\n}\n\nfunction setupTermynal() {\n document.querySelectorAll(\".use-termynal\").forEach(node => {\n node.style.display = \"block\";\n new Termynal(node, {\n lineDelay: 500\n });\n });\n const progressLiteralStart = \"---> 100%\";\n const promptLiteralStart = \"$ \";\n const customPromptLiteralStart = \"# \";\n const termynalActivateClass = \"termy\";\n let termynals = [];\n\n function createTermynals() {\n document\n .querySelectorAll(`.${termynalActivateClass} .highlight`)\n .forEach(node => {\n const text = node.textContent;\n const lines = text.split(\"\\n\");\n const useLines = [];\n let buffer = [];\n function saveBuffer() {\n if (buffer.length) {\n let isBlankSpace = true;\n buffer.forEach(line => {\n if (line) {\n isBlankSpace = false;\n }\n });\n dataValue = {};\n if (isBlankSpace) {\n dataValue[\"delay\"] = 0;\n }\n if (buffer[buffer.length - 1] === \"\") {\n // A last single ![](\"bigben.png\")
\n\n# In this notebook, we are going to replicate the design of the clockface from first principles using the\n# Chalk library. This project was done for fun without any knowledge of clockmaking or even the right\n# terminology. It is meant mainly as an introduction programmatic 2D diagramming.\n\n# Here is what it will look like when we are done.\n\n# ![](\"chalk_bigben.svg\")
\n\n# ## Preliminary: Roman Numerals\n\nfrom chalk import *\nfrom colour import Color\n\n# The whole diagram a simple color pallet of gold black and a bit of grey.\n\ngold = Color(\"#E7D49C\")\nwhite = Color(\"#CCCCCC\")\nblack = Color(\"black\")\ngrey = Color(\"#444444\")\n\n\n# To begin, we will introduce some of the concepts of the Chalk library\n# by mimicking the shape of the roman numeral I, V, and X.\n\n# \n\n# Chalk uses basic shapes to build up compositional diagrams. For instance here\n# is a filled rectangle.\n\ncolumn = rectangle(1, 4).fill_color(black)\ncolumn\n\n# Each diagram has style properties and an \"envelope\" that describes\n# its boundaries. Envelopes are a bit complex, they roughly are the\n# the bounding box of the diagram.\n\ncolumn.show_envelope()\n\n# Next lets make a diamond with an inlay. To do this we use `+` to put a\n# grey box on a black box.\n\ndiamond = rectangle(1, 1).fill_color(black) + rectangle(0.5, 0.5).fill_color(grey)\ndiamond\n\n# The benefit of the envelope representation is that it behaves more\n# intuitively under affine transformations like rotation.\n\ndiamond = diamond.rotate_by(1 / 8)\ndiamond.show_envelope()\n\n\n# We can easily combine diagrams. To see what a combination will look\n# like we can use the `show_beside` method. You give it a vector along\n# which to combine.\n\ncolumn.show_beside(diamond, -unit_y)\n\n# We can also update the envelope of diagrams before combination.\n# For instance here we substitute a small envelope for overlap.\n\ncolumn = column.with_envelope(rectangle(1, 2.5))\ncolumn.show_beside(diamond, -unit_y)\n\n# When stacking on top we can use the shortcut `/`. The function `center_xy` resets\n# the center to the middle of the envelope.\n\ni = ((column / diamond).beside(diamond, -unit_y)).center_xy()\ni = i + rectangle(0.01, 4).line_color(grey)\ni.show_envelope()\n\n# We can also put diagrams next to each other using the `|` notation.\n\nii = i | i\nii\n\n# We can similar create diagrams for the other roman numerals.\n# The `align` functions also re-center diagrams.\n\nv = rectangle(1.5, 1).fill_color(black).align_bl() + i.align_b()\nv\n\n\n# Changing the center allows us to use `+` which joins diagrams together at the origin.\n\n\nv = (v.align_br() + i.align_b()).center_xy()\nv\n\n\n# Creating X is a bit harder. We use two transformations to help us out.\n# Using `translate` helps us nudge diagrams away from the origin.\n\n\nddiamond = (diamond | diamond).translate(-0.5, 0)\nddiamond.show_origin()\n\n# Using `shear` lets us create a center line with a diagonal slash.\n\nmid = (\n rectangle(2, 0.5).fill_color(black) + rectangle(1.5, 0.1).fill_color(grey)\n).shear_x(-0.2)\nmid\n\n\n# We can then combine these complex diagrams together.\ncolumn = column\nx = ((column / ddiamond) + mid).beside(ddiamond, -unit_y).center_xy()\nx\n\n\n# Compositionality is fun. We can take these shapes and make numbers from 1-12.\n\nnumbers = [\n x | i | i,\n i,\n i | i,\n i | i | i,\n i | v,\n v,\n v | i,\n v | i | i,\n v | i | i | i,\n i | x,\n x,\n x | i,\n]\n\n\n# We can draw the main clock-face by moving each number to the edge, and then rotating it\n# to its location. The `concat` combinator glues each of these together at the origin.\n\n\npart0 = concat(\n [\n n.center_xy().scale(0.05).translate_by(-unit_y).rotate_by(-i / 12)\n for i, n in enumerate(numbers)\n ]\n)\n\nset_svg_height(300)\npart0.show_origin()\n\n\n# ## Inner Pattern\n\n# \n\n# This inner pattern is a bit more complex. We are going to need more than just\n# simple shapes to draw it.\n\n# To start, let us make a function for rotational symmetry.\n\n\ndef rot_cycle(d: Diagram, times: int) -> Diagram:\n \"Rotate diagram around a circle.\"\n return concat(d.rotate_by(i / times) for i in range(times))\n\n\n# To try it out, we make the inner pattern by making a circle and\n# rotating it around 12 times.\n\nset_svg_height(200)\n\nwidth = -4.4\ninner_circle = rot_cycle(circle(1.1).translate(0, width), 12).rotate_by(\n (1 / 12) / 2\n) + circle(3).fill_color(black)\ninner_circle\n\n\n# Now we want to trace a trail that looks like the inner patttern.\n# There is no magic here, just a little geometry to guess the shapes.\n# Vectors `unit_y` and `unit_x` are geometric helpers.\n\nu45 = unit_x.rotate(-45)\nu60 = unit_x.rotate(60)\ndiffy = abs(u45.y / u60.y)\ndiffx = diffy * abs(u60.x / u45.x)\n\n# A `Trail` is a sequence of vectors drawn in order.\n# Once you are done drawing one you can use `stroke` to\n# make it a diagram. We start at the top left and draw\n# downward.\n\nfudge = 0.73\ny = (\n Trail.from_offsets(\n [\n u45,\n diffy * u60,\n -diffy * u60,\n -fudge * u60,\n fudge * u60,\n diffx * u45,\n diffx * unit_y,\n ]\n )\n .stroke()\n .align_br()\n)\ny.show_origin()\n\n\n# To draw the curve we use `arc_between` which\n# connects two points with a specified radius.\n\ncurve = 0.5\nunder_arc = arc_between(-unit_x, 2 * -unit_y, curve).align_tr()\nunder_arc.show_origin()\n\n# We then combine them to the right scale.\n\npattern = (y.scale(3) / under_arc).align_r()\npattern.show_origin()\n\n# And then use reflection to double the pattern.\n\npattern = (pattern + pattern.reflect_x()).align_b()\npattern\n\n\n# We can then rotate this to create the whole pattern. We set the\n# fudge factor above to make the pattern connect.\n\nset_svg_height(300)\npart1 = inner_circle + rot_cycle(pattern.translate(0, width - 1), 12)\npart1 = part1.line_color(gold).line_width(0.2)\npart1\n\n# Looks pretty close to the original!\n\n# \n\n\n# ## Outer Bands\n\n\n# \n\n\n# With the functions we have so far it is not so hard to do the rest of the main\n# clock-face. The maink point worth noting is that we can build each part without\n# needing to know the sizes of the others. This makes it easy to debug and update.\n\n\n# The first band is two circles with a black dots. Nothing new.\n\nset_svg_height(200)\n\nband1 = (circle(1.1).line_width(0.1) + circle(1)).line_width(0.2) + rot_cycle(\n diamond.scale(0.05).translate(1.05, 0), 12\n)\nband1\n\n\n# Band two has thin dividing lines and the hour markers from part 0.\n# In order to fit in the numbers we write a function that lets us scale to a given circle.\n\n\ndef fit_in(b: Diagram, s: Diagram, frame=0.1) -> Diagram:\n # Find the inner radius\n m = min([x for x in b.get_trace()(origin, unit_x) if x > 0])\n\n # Scale the inner diagram to that size\n return b + s.scale_uniform_to_x(2 * m - frame)\n\n\n# We use this to put the numbers in a circle.\n\nband2 = fit_in(circle(1.4), part0, 0.1) + circle(1)\nband2\n\n# We then draw thin lines in this region.\n\n\ndef thin_line(h):\n return rectangle(h, 0.001).fill_color(black).center_xy().line_width(0.01)\n\n\nlines = thin_line(0.4)\nband2 = band2 + rot_cycle(lines.translate(1.2, 0), 48)\nband2\n\n\n# Band 3 has a little jewel cross. We can draw this with shapes.\n\ndiamond = rectangle(1, 1).rotate_by(1 / 8).fill_color(black).line_color(black)\ns = (\n (diamond | rectangle(2, 1).with_envelope(rectangle(1, 1)) | diamond)\n .fill_color(black)\n .line_color(black)\n .center_xy()\n)\ns = s.scale_y(0.5) + s.rotate_by(0.25).scale_y(0.75).scale_x(0.25)\njewel = s.rotate_by(0.25)\njewel\n\n\n# Draw the outlines\n\na = 1.8\nc = 1.7\nb = 1.6\nband3 = (\n circle(2.0).line_width(0.7)\n + (circle(a) + circle(b)).line_width(0.3)\n + circle(1.4).line_width(0.4)\n)\nband3\n\n# Add the thin lines and rounded rect tracks\n\ntrack = rectangle(0.33, 0.001, 0.1).fill_color(black).center_xy().line_width(0.01)\nband3 = (\n band3\n + rot_cycle(track.line_width(0.3).translate(c, 0), 60)\n + rot_cycle(thin_line(0.6).translate(c, 0).rotate_by(1 / 48), 48)\n)\nband3\n\n# Add the jewel.\n\nband3 = band3 + rot_cycle(\n jewel.center_xy().scale_uniform_to_x((a - b) * 2).translate(0, c), 12\n)\nband3\n\n# And voila.\n\npart2 = fit_in(band3, fit_in(band2, band1))\nset_svg_height(300)\npart2\n\n# Looks pretty close to the original!\n\n# \n\n# ## Frame\n\n# !![](\"intro-01.png\")
\n \n ![](\"intro-02.png\")
\n \n ![](\"intro-03.png\")
\n \n ![](\"intro-04.png\")
\n \n ![](\"normalized.png\")
\n \n ![](\"escher-square-limit.png\")
\n \n ![](\"hex-variation.png\")
\n \n ![](\"koch.png\")
\n \n ![](\"squares.png\")
\n \n ![](\"hanoi.png\")
\n \n ![](\"hilbert.png\")
\n \n ![](\"lenet.png\")
\n \n ![](\"logo.png\")
\n \n ![](\"tournament-network.png\")
\n \n ![](\"arrows.png\")
\n \n ![](\"path.png\")
\n \n ![](\"tensor.png\")
\n \n ![](\"tree.png\")
\n \n ![](\"{{x}}.png\")
\n \n