From 7b5e1523e98bfa46844cee28ff8898061dc1c820 Mon Sep 17 00:00:00 2001 From: <> Date: Thu, 9 Nov 2023 07:20:25 +0000 Subject: [PATCH] Deployed d886e15 with MkDocs version: 1.5.3 --- .nojekyll | 0 404.html | 1911 +++++ about/index.html | 2079 +++++ assets/images/favicon.png | Bin 0 -> 1870 bytes assets/javascripts/bundle.a5ca32a6.min.js | 3 + assets/javascripts/lunr/min/lunr.ar.min.js | 1 + assets/javascripts/lunr/min/lunr.da.min.js | 18 + assets/javascripts/lunr/min/lunr.de.min.js | 18 + assets/javascripts/lunr/min/lunr.du.min.js | 18 + assets/javascripts/lunr/min/lunr.el.min.js | 1 + assets/javascripts/lunr/min/lunr.es.min.js | 18 + assets/javascripts/lunr/min/lunr.fi.min.js | 18 + assets/javascripts/lunr/min/lunr.fr.min.js | 18 + assets/javascripts/lunr/min/lunr.he.min.js | 1 + assets/javascripts/lunr/min/lunr.hi.min.js | 1 + assets/javascripts/lunr/min/lunr.hu.min.js | 18 + assets/javascripts/lunr/min/lunr.hy.min.js | 1 + assets/javascripts/lunr/min/lunr.it.min.js | 18 + assets/javascripts/lunr/min/lunr.ja.min.js | 1 + assets/javascripts/lunr/min/lunr.jp.min.js | 1 + assets/javascripts/lunr/min/lunr.kn.min.js | 1 + assets/javascripts/lunr/min/lunr.ko.min.js | 1 + assets/javascripts/lunr/min/lunr.multi.min.js | 1 + assets/javascripts/lunr/min/lunr.nl.min.js | 18 + assets/javascripts/lunr/min/lunr.no.min.js | 18 + assets/javascripts/lunr/min/lunr.pt.min.js | 18 + assets/javascripts/lunr/min/lunr.ro.min.js | 18 + assets/javascripts/lunr/min/lunr.ru.min.js | 18 + assets/javascripts/lunr/min/lunr.sa.min.js | 1 + .../lunr/min/lunr.stemmer.support.min.js | 1 + assets/javascripts/lunr/min/lunr.sv.min.js | 18 + assets/javascripts/lunr/min/lunr.ta.min.js | 1 + assets/javascripts/lunr/min/lunr.te.min.js | 1 + assets/javascripts/lunr/min/lunr.th.min.js | 1 + assets/javascripts/lunr/min/lunr.tr.min.js | 18 + assets/javascripts/lunr/min/lunr.vi.min.js | 1 + assets/javascripts/lunr/min/lunr.zh.min.js | 1 + assets/javascripts/lunr/tinyseg.js | 206 + assets/javascripts/lunr/wordcut.js | 6708 +++++++++++++++++ .../workers/search.1e90e0fb.min.js | 2 + assets/stylesheets/main.382dd0b9.min.css | 1 + assets/stylesheets/palette.ab4e12ef.min.css | 1 + diagrams/foreign_keys.drawio.png | Bin 0 -> 8392 bytes diagrams/high_level_flow-basic-flow.svg | 3 + diagrams/high_level_flow-high-level-dark.svg | 3 + diagrams/high_level_flow-high-level.svg | 3 + ...evel_flow-run-config-basic-flow.drawio.svg | 4 + diagrams/high_level_flow-run-config.svg | 3 + .../logo/data_catering_landscape_banner.svg | 1 + diagrams/logo/data_catering_logo.svg | 1 + diagrams/logo/data_catering_transparent.svg | 1 + diagrams/logo/data_catering_with_title.svg | 1 + .../logo/data_catering_with_title_medium.svg | 1 + diagrams/marquez_dashboard.png | Bin 0 -> 77578 bytes diagrams/openmetadata_dashboard.png | Bin 0 -> 97994 bytes diagrams/solace_dashboard.png | Bin 0 -> 19782 bytes diagrams/solace_messages_queued.png | Bin 0 -> 96532 bytes .../use_case_replicate_production.drawio.svg | 4 + diagrams/use_case_replicate_production.svg | 3 + get-started/docker/index.html | 2104 ++++++ index.html | 2196 ++++++ js/open_in_new_tab.js | 45 + legal/privacy-policy/index.html | 2131 ++++++ legal/terms-of-service/index.html | 2115 ++++++ pricing/index.html | 2081 +++++ sample/datafaker/expressions.txt | 1024 +++ sample/report/html/data-sources.html | 178 + .../report/html/data_catering_transparent.svg | 1 + sample/report/html/index.html | 275 + sample/report/html/main.css | 173 + sample/report/html/steps.html | 1233 +++ sample/report/html/tasks.html | 105 + sample/report/html/validations.html | 410 + sample/report/report_screenshot.png | Bin 0 -> 87497 bytes search/search_index.json | 1 + setup/advanced/advanced/index.html | 2311 ++++++ setup/configuration/index.html | 2476 ++++++ setup/connection/connection/index.html | 2750 +++++++ setup/deployment/deployment/index.html | 2072 +++++ setup/foreign-key/foreign-key/index.html | 2348 ++++++ setup/generator/count/index.html | 2250 ++++++ setup/generator/generator/index.html | 3080 ++++++++ setup/generator/report/index.html | 2047 +++++ setup/guide/data-source/cassandra/index.html | 2637 +++++++ setup/guide/data-source/http/index.html | 2404 ++++++ setup/guide/data-source/kafka/index.html | 2499 ++++++ .../marquez-metadata-source/index.html | 2375 ++++++ .../open-metadata-source/index.html | 2453 ++++++ setup/guide/data-source/solace/index.html | 2497 ++++++ setup/guide/index.html | 2296 ++++++ .../auto-generate-connection/index.html | 2309 ++++++ .../guide/scenario/batch-and-event/index.html | 2315 ++++++ .../scenario/delete-generated-data/index.html | 2300 ++++++ .../scenario/first-data-generation/index.html | 3020 ++++++++ .../scenario/records-per-column/index.html | 2264 ++++++ setup/index.html | 2082 +++++ setup/validation/basic-validation/index.html | 3047 ++++++++ .../validation/group-by-validation/index.html | 2160 ++++++ setup/validation/validation/index.html | 2341 ++++++ sitemap.xml | 173 + sitemap.xml.gz | Bin 0 -> 524 bytes stylesheets/extra.css | 23 + use-case/business-value/index.html | 2037 +++++ use-case/comparison/index.html | 2190 ++++++ use-case/roadmap/index.html | 2081 +++++ use-case/use-case/index.html | 2161 ++++++ 106 files changed, 92296 insertions(+) create mode 100644 .nojekyll create mode 100644 404.html create mode 100644 about/index.html create mode 100644 assets/images/favicon.png create mode 100644 assets/javascripts/bundle.a5ca32a6.min.js create mode 100644 assets/javascripts/lunr/min/lunr.ar.min.js create mode 100644 assets/javascripts/lunr/min/lunr.da.min.js create mode 100644 assets/javascripts/lunr/min/lunr.de.min.js create mode 100644 assets/javascripts/lunr/min/lunr.du.min.js create mode 100644 assets/javascripts/lunr/min/lunr.el.min.js create mode 100644 assets/javascripts/lunr/min/lunr.es.min.js create mode 100644 assets/javascripts/lunr/min/lunr.fi.min.js create mode 100644 assets/javascripts/lunr/min/lunr.fr.min.js create mode 100644 assets/javascripts/lunr/min/lunr.he.min.js create mode 100644 assets/javascripts/lunr/min/lunr.hi.min.js create mode 100644 assets/javascripts/lunr/min/lunr.hu.min.js create mode 100644 assets/javascripts/lunr/min/lunr.hy.min.js create mode 100644 assets/javascripts/lunr/min/lunr.it.min.js create mode 100644 assets/javascripts/lunr/min/lunr.ja.min.js create mode 100644 assets/javascripts/lunr/min/lunr.jp.min.js create mode 100644 assets/javascripts/lunr/min/lunr.kn.min.js create mode 100644 assets/javascripts/lunr/min/lunr.ko.min.js create mode 100644 assets/javascripts/lunr/min/lunr.multi.min.js create mode 100644 assets/javascripts/lunr/min/lunr.nl.min.js create mode 100644 assets/javascripts/lunr/min/lunr.no.min.js create mode 100644 assets/javascripts/lunr/min/lunr.pt.min.js create mode 100644 assets/javascripts/lunr/min/lunr.ro.min.js create mode 100644 assets/javascripts/lunr/min/lunr.ru.min.js create mode 100644 assets/javascripts/lunr/min/lunr.sa.min.js create mode 100644 assets/javascripts/lunr/min/lunr.stemmer.support.min.js create mode 100644 assets/javascripts/lunr/min/lunr.sv.min.js create mode 100644 assets/javascripts/lunr/min/lunr.ta.min.js create mode 100644 assets/javascripts/lunr/min/lunr.te.min.js create mode 100644 assets/javascripts/lunr/min/lunr.th.min.js create mode 100644 assets/javascripts/lunr/min/lunr.tr.min.js create mode 100644 assets/javascripts/lunr/min/lunr.vi.min.js create mode 100644 assets/javascripts/lunr/min/lunr.zh.min.js create mode 100644 assets/javascripts/lunr/tinyseg.js create mode 100644 assets/javascripts/lunr/wordcut.js create mode 100644 assets/javascripts/workers/search.1e90e0fb.min.js create mode 100644 assets/stylesheets/main.382dd0b9.min.css create mode 100644 assets/stylesheets/palette.ab4e12ef.min.css create mode 100644 diagrams/foreign_keys.drawio.png create mode 100644 diagrams/high_level_flow-basic-flow.svg create mode 100644 diagrams/high_level_flow-high-level-dark.svg create mode 100644 diagrams/high_level_flow-high-level.svg create mode 100644 diagrams/high_level_flow-run-config-basic-flow.drawio.svg create mode 100644 diagrams/high_level_flow-run-config.svg create mode 100644 diagrams/logo/data_catering_landscape_banner.svg create mode 100644 diagrams/logo/data_catering_logo.svg create mode 100644 diagrams/logo/data_catering_transparent.svg create mode 100644 diagrams/logo/data_catering_with_title.svg create mode 100644 diagrams/logo/data_catering_with_title_medium.svg create mode 100644 diagrams/marquez_dashboard.png create mode 100644 diagrams/openmetadata_dashboard.png create mode 100644 diagrams/solace_dashboard.png create mode 100644 diagrams/solace_messages_queued.png create mode 100644 diagrams/use_case_replicate_production.drawio.svg create mode 100644 diagrams/use_case_replicate_production.svg create mode 100644 get-started/docker/index.html create mode 100644 index.html create mode 100644 js/open_in_new_tab.js create mode 100644 legal/privacy-policy/index.html create mode 100644 legal/terms-of-service/index.html create mode 100644 pricing/index.html create mode 100644 sample/datafaker/expressions.txt create mode 100644 sample/report/html/data-sources.html create mode 100644 sample/report/html/data_catering_transparent.svg create mode 100644 sample/report/html/index.html create mode 100644 sample/report/html/main.css create mode 100644 sample/report/html/steps.html create mode 100644 sample/report/html/tasks.html create mode 100644 sample/report/html/validations.html create mode 100644 sample/report/report_screenshot.png create mode 100644 search/search_index.json create mode 100644 setup/advanced/advanced/index.html create mode 100644 setup/configuration/index.html create mode 100644 setup/connection/connection/index.html create mode 100644 setup/deployment/deployment/index.html create mode 100644 setup/foreign-key/foreign-key/index.html create mode 100644 setup/generator/count/index.html create mode 100644 setup/generator/generator/index.html create mode 100644 setup/generator/report/index.html create mode 100644 setup/guide/data-source/cassandra/index.html create mode 100644 setup/guide/data-source/http/index.html create mode 100644 setup/guide/data-source/kafka/index.html create mode 100644 setup/guide/data-source/marquez-metadata-source/index.html create mode 100644 setup/guide/data-source/open-metadata-source/index.html create mode 100644 setup/guide/data-source/solace/index.html create mode 100644 setup/guide/index.html create mode 100644 setup/guide/scenario/auto-generate-connection/index.html create mode 100644 setup/guide/scenario/batch-and-event/index.html create mode 100644 setup/guide/scenario/delete-generated-data/index.html create mode 100644 setup/guide/scenario/first-data-generation/index.html create mode 100644 setup/guide/scenario/records-per-column/index.html create mode 100644 setup/index.html create mode 100644 setup/validation/basic-validation/index.html create mode 100644 setup/validation/group-by-validation/index.html create mode 100644 setup/validation/validation/index.html create mode 100644 sitemap.xml create mode 100644 sitemap.xml.gz create mode 100644 stylesheets/extra.css create mode 100644 use-case/business-value/index.html create mode 100644 use-case/comparison/index.html create mode 100644 use-case/roadmap/index.html create mode 100644 use-case/use-case/index.html diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 00000000..e69de29b diff --git a/404.html b/404.html new file mode 100644 index 00000000..cece0ace --- /dev/null +++ b/404.html @@ -0,0 +1,1911 @@ + + + + + + + + + + + + + + + + + + + + + + Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ +

404 - Not found

+ +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/about/index.html b/about/index.html new file mode 100644 index 00000000..72cfb3b3 --- /dev/null +++ b/about/index.html @@ -0,0 +1,2079 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + About - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + Skip to content + + +
+
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

About

+

Hi, my name is Peter. I am a independent Software Developer, mainly focussing on data related services. My experience +can be found on my LinkedIn.

+

I have created Data Caterer to help serve individuals and companies with data generation and data testing. It is a +complex area that has many edge cases or intricacies that are hard to summarise or turn into something actionable and +repeatable. Through the use of metadata, Data Caterer can help simplify your data testing, simulating production +environment data, aid in data debugging, or whatever your data use case may be.

+

Given that it is going to save you and your team time and money, please help in considering financial support. This will +help the product grow into a sustainable and feature-full service.

+

Contact

+

Please contact Peter Flook +via Slack +or via email peter.flook@data.catering if you have any questions or queries.

+

Terms of service

+

Terms of service can be found here.

+

Privacy policy

+

Privacy policy can be found here.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/assets/images/favicon.png b/assets/images/favicon.png new file mode 100644 index 0000000000000000000000000000000000000000..1cf13b9f9d978896599290a74f77d5dbe7d1655c GIT binary patch literal 1870 zcmV-U2eJ5xP)Gc)JR9QMau)O=X#!i9;T z37kk-upj^(fsR36MHs_+1RCI)NNu9}lD0S{B^g8PN?Ww(5|~L#Ng*g{WsqleV}|#l zz8@ri&cTzw_h33bHI+12+kK6WN$h#n5cD8OQt`5kw6p~9H3()bUQ8OS4Q4HTQ=1Ol z_JAocz`fLbT2^{`8n~UAo=#AUOf=SOq4pYkt;XbC&f#7lb$*7=$na!mWCQ`dBQsO0 zLFBSPj*N?#u5&pf2t4XjEGH|=pPQ8xh7tpx;US5Cx_Ju;!O`ya-yF`)b%TEt5>eP1ZX~}sjjA%FJF?h7cX8=b!DZl<6%Cv z*G0uvvU+vmnpLZ2paivG-(cd*y3$hCIcsZcYOGh{$&)A6*XX&kXZd3G8m)G$Zz-LV z^GF3VAW^Mdv!)4OM8EgqRiz~*Cji;uzl2uC9^=8I84vNp;ltJ|q-*uQwGp2ma6cY7 z;`%`!9UXO@fr&Ebapfs34OmS9^u6$)bJxrucutf>`dKPKT%%*d3XlFVKunp9 zasduxjrjs>f8V=D|J=XNZp;_Zy^WgQ$9WDjgY=z@stwiEBm9u5*|34&1Na8BMjjgf3+SHcr`5~>oz1Y?SW^=K z^bTyO6>Gar#P_W2gEMwq)ot3; zREHn~U&Dp0l6YT0&k-wLwYjb?5zGK`W6S2v+K>AM(95m2C20L|3m~rN8dprPr@t)5lsk9Hu*W z?pS990s;Ez=+Rj{x7p``4>+c0G5^pYnB1^!TL=(?HLHZ+HicG{~4F1d^5Awl_2!1jICM-!9eoLhbbT^;yHcefyTAaqRcY zmuctDopPT!%k+}x%lZRKnzykr2}}XfG_ne?nRQO~?%hkzo;@RN{P6o`&mMUWBYMTe z6i8ChtjX&gXl`nvrU>jah)2iNM%JdjqoaeaU%yVn!^70x-flljp6Q5tK}5}&X8&&G zX3fpb3E(!rH=zVI_9Gjl45w@{(ITqngWFe7@9{mX;tO25Z_8 zQHEpI+FkTU#4xu>RkN>b3Tnc3UpWzPXWm#o55GKF09j^Mh~)K7{QqbO_~(@CVq! zS<8954|P8mXN2MRs86xZ&Q4EfM@JB94b=(YGuk)s&^jiSF=t3*oNK3`rD{H`yQ?d; ztE=laAUoZx5?RC8*WKOj`%LXEkgDd>&^Q4M^z`%u0rg-It=hLCVsq!Z%^6eB-OvOT zFZ28TN&cRmgU}Elrnk43)!>Z1FCPL2K$7}gwzIc48NX}#!A1BpJP?#v5wkNprhV** z?Cpalt1oH&{r!o3eSKc&ap)iz2BTn_VV`4>9M^b3;(YY}4>#ML6{~(4mH+?%07*qo IM6N<$f(jP3KmY&$ literal 0 HcmV?d00001 diff --git a/assets/javascripts/bundle.a5ca32a6.min.js b/assets/javascripts/bundle.a5ca32a6.min.js new file mode 100644 index 00000000..7ba44c99 --- /dev/null +++ b/assets/javascripts/bundle.a5ca32a6.min.js @@ -0,0 +1,3 @@ +"use strict";(()=>{var Hi=Object.create;var Or=Object.defineProperty;var $i=Object.getOwnPropertyDescriptor;var Ri=Object.getOwnPropertyNames,Dt=Object.getOwnPropertySymbols,Pi=Object.getPrototypeOf,Mr=Object.prototype.hasOwnProperty,po=Object.prototype.propertyIsEnumerable;var co=(e,t,r)=>t in e?Or(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r,j=(e,t)=>{for(var r in t||(t={}))Mr.call(t,r)&&co(e,r,t[r]);if(Dt)for(var r of Dt(t))po.call(t,r)&&co(e,r,t[r]);return e};var lo=(e,t)=>{var r={};for(var o in e)Mr.call(e,o)&&t.indexOf(o)<0&&(r[o]=e[o]);if(e!=null&&Dt)for(var o of Dt(e))t.indexOf(o)<0&&po.call(e,o)&&(r[o]=e[o]);return r};var Lr=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports);var Ii=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of Ri(t))!Mr.call(e,n)&&n!==r&&Or(e,n,{get:()=>t[n],enumerable:!(o=$i(t,n))||o.enumerable});return e};var Vt=(e,t,r)=>(r=e!=null?Hi(Pi(e)):{},Ii(t||!e||!e.__esModule?Or(r,"default",{value:e,enumerable:!0}):r,e));var fo=Lr((_r,mo)=>{(function(e,t){typeof _r=="object"&&typeof mo!="undefined"?t():typeof define=="function"&&define.amd?define(t):t()})(_r,function(){"use strict";function e(r){var o=!0,n=!1,i=null,a={text:!0,search:!0,url:!0,tel:!0,email:!0,password:!0,number:!0,date:!0,month:!0,week:!0,time:!0,datetime:!0,"datetime-local":!0};function s(C){return!!(C&&C!==document&&C.nodeName!=="HTML"&&C.nodeName!=="BODY"&&"classList"in C&&"contains"in C.classList)}function c(C){var et=C.type,H=C.tagName;return!!(H==="INPUT"&&a[et]&&!C.readOnly||H==="TEXTAREA"&&!C.readOnly||C.isContentEditable)}function p(C){C.classList.contains("focus-visible")||(C.classList.add("focus-visible"),C.setAttribute("data-focus-visible-added",""))}function l(C){C.hasAttribute("data-focus-visible-added")&&(C.classList.remove("focus-visible"),C.removeAttribute("data-focus-visible-added"))}function f(C){C.metaKey||C.altKey||C.ctrlKey||(s(r.activeElement)&&p(r.activeElement),o=!0)}function u(C){o=!1}function h(C){s(C.target)&&(o||c(C.target))&&p(C.target)}function v(C){s(C.target)&&(C.target.classList.contains("focus-visible")||C.target.hasAttribute("data-focus-visible-added"))&&(n=!0,window.clearTimeout(i),i=window.setTimeout(function(){n=!1},100),l(C.target))}function b(C){document.visibilityState==="hidden"&&(n&&(o=!0),U())}function U(){document.addEventListener("mousemove",X),document.addEventListener("mousedown",X),document.addEventListener("mouseup",X),document.addEventListener("pointermove",X),document.addEventListener("pointerdown",X),document.addEventListener("pointerup",X),document.addEventListener("touchmove",X),document.addEventListener("touchstart",X),document.addEventListener("touchend",X)}function Y(){document.removeEventListener("mousemove",X),document.removeEventListener("mousedown",X),document.removeEventListener("mouseup",X),document.removeEventListener("pointermove",X),document.removeEventListener("pointerdown",X),document.removeEventListener("pointerup",X),document.removeEventListener("touchmove",X),document.removeEventListener("touchstart",X),document.removeEventListener("touchend",X)}function X(C){C.target.nodeName&&C.target.nodeName.toLowerCase()==="html"||(o=!1,Y())}document.addEventListener("keydown",f,!0),document.addEventListener("mousedown",u,!0),document.addEventListener("pointerdown",u,!0),document.addEventListener("touchstart",u,!0),document.addEventListener("visibilitychange",b,!0),U(),r.addEventListener("focus",h,!0),r.addEventListener("blur",v,!0),r.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&r.host?r.host.setAttribute("data-js-focus-visible",""):r.nodeType===Node.DOCUMENT_NODE&&(document.documentElement.classList.add("js-focus-visible"),document.documentElement.setAttribute("data-js-focus-visible",""))}if(typeof window!="undefined"&&typeof document!="undefined"){window.applyFocusVisiblePolyfill=e;var t;try{t=new CustomEvent("focus-visible-polyfill-ready")}catch(r){t=document.createEvent("CustomEvent"),t.initCustomEvent("focus-visible-polyfill-ready",!1,!1,{})}window.dispatchEvent(t)}typeof document!="undefined"&&e(document)})});var eo=Lr((It,Zr)=>{(function(t,r){typeof It=="object"&&typeof Zr=="object"?Zr.exports=r():typeof define=="function"&&define.amd?define([],r):typeof It=="object"?It.ClipboardJS=r():t.ClipboardJS=r()})(It,function(){return function(){var e={686:function(o,n,i){"use strict";i.d(n,{default:function(){return ki}});var a=i(279),s=i.n(a),c=i(370),p=i.n(c),l=i(817),f=i.n(l);function u(q){try{return document.execCommand(q)}catch(_){return!1}}var h=function(_){var L=f()(_);return u("cut"),L},v=h;function b(q){var _=document.documentElement.getAttribute("dir")==="rtl",L=document.createElement("textarea");L.style.fontSize="12pt",L.style.border="0",L.style.padding="0",L.style.margin="0",L.style.position="absolute",L.style[_?"right":"left"]="-9999px";var F=window.pageYOffset||document.documentElement.scrollTop;return L.style.top="".concat(F,"px"),L.setAttribute("readonly",""),L.value=q,L}var U=function(_,L){var F=b(_);L.container.appendChild(F);var V=f()(F);return u("copy"),F.remove(),V},Y=function(_){var L=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body},F="";return typeof _=="string"?F=U(_,L):_ instanceof HTMLInputElement&&!["text","search","url","tel","password"].includes(_==null?void 0:_.type)?F=U(_.value,L):(F=f()(_),u("copy")),F},X=Y;function C(q){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?C=function(L){return typeof L}:C=function(L){return L&&typeof Symbol=="function"&&L.constructor===Symbol&&L!==Symbol.prototype?"symbol":typeof L},C(q)}var et=function(){var _=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{},L=_.action,F=L===void 0?"copy":L,V=_.container,G=_.target,Ie=_.text;if(F!=="copy"&&F!=="cut")throw new Error('Invalid "action" value, use either "copy" or "cut"');if(G!==void 0)if(G&&C(G)==="object"&&G.nodeType===1){if(F==="copy"&&G.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if(F==="cut"&&(G.hasAttribute("readonly")||G.hasAttribute("disabled")))throw new Error(`Invalid "target" attribute. You can't cut text from elements with "readonly" or "disabled" attributes`)}else throw new Error('Invalid "target" value, use a valid Element');if(Ie)return X(Ie,{container:V});if(G)return F==="cut"?v(G):X(G,{container:V})},H=et;function B(q){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?B=function(L){return typeof L}:B=function(L){return L&&typeof Symbol=="function"&&L.constructor===Symbol&&L!==Symbol.prototype?"symbol":typeof L},B(q)}function ce(q,_){if(!(q instanceof _))throw new TypeError("Cannot call a class as a function")}function ue(q,_){for(var L=0;L<_.length;L++){var F=_[L];F.enumerable=F.enumerable||!1,F.configurable=!0,"value"in F&&(F.writable=!0),Object.defineProperty(q,F.key,F)}}function we(q,_,L){return _&&ue(q.prototype,_),L&&ue(q,L),q}function Ye(q,_){if(typeof _!="function"&&_!==null)throw new TypeError("Super expression must either be null or a function");q.prototype=Object.create(_&&_.prototype,{constructor:{value:q,writable:!0,configurable:!0}}),_&&Tr(q,_)}function Tr(q,_){return Tr=Object.setPrototypeOf||function(F,V){return F.__proto__=V,F},Tr(q,_)}function Mi(q){var _=Ai();return function(){var F=Nt(q),V;if(_){var G=Nt(this).constructor;V=Reflect.construct(F,arguments,G)}else V=F.apply(this,arguments);return Li(this,V)}}function Li(q,_){return _&&(B(_)==="object"||typeof _=="function")?_:_i(q)}function _i(q){if(q===void 0)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return q}function Ai(){if(typeof Reflect=="undefined"||!Reflect.construct||Reflect.construct.sham)return!1;if(typeof Proxy=="function")return!0;try{return Date.prototype.toString.call(Reflect.construct(Date,[],function(){})),!0}catch(q){return!1}}function Nt(q){return Nt=Object.setPrototypeOf?Object.getPrototypeOf:function(L){return L.__proto__||Object.getPrototypeOf(L)},Nt(q)}function Sr(q,_){var L="data-clipboard-".concat(q);if(_.hasAttribute(L))return _.getAttribute(L)}var Ci=function(q){Ye(L,q);var _=Mi(L);function L(F,V){var G;return ce(this,L),G=_.call(this),G.resolveOptions(V),G.listenClick(F),G}return we(L,[{key:"resolveOptions",value:function(){var V=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{};this.action=typeof V.action=="function"?V.action:this.defaultAction,this.target=typeof V.target=="function"?V.target:this.defaultTarget,this.text=typeof V.text=="function"?V.text:this.defaultText,this.container=B(V.container)==="object"?V.container:document.body}},{key:"listenClick",value:function(V){var G=this;this.listener=p()(V,"click",function(Ie){return G.onClick(Ie)})}},{key:"onClick",value:function(V){var G=V.delegateTarget||V.currentTarget,Ie=this.action(G)||"copy",Ut=H({action:Ie,container:this.container,target:this.target(G),text:this.text(G)});this.emit(Ut?"success":"error",{action:Ie,text:Ut,trigger:G,clearSelection:function(){G&&G.focus(),window.getSelection().removeAllRanges()}})}},{key:"defaultAction",value:function(V){return Sr("action",V)}},{key:"defaultTarget",value:function(V){var G=Sr("target",V);if(G)return document.querySelector(G)}},{key:"defaultText",value:function(V){return Sr("text",V)}},{key:"destroy",value:function(){this.listener.destroy()}}],[{key:"copy",value:function(V){var G=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body};return X(V,G)}},{key:"cut",value:function(V){return v(V)}},{key:"isSupported",value:function(){var V=arguments.length>0&&arguments[0]!==void 0?arguments[0]:["copy","cut"],G=typeof V=="string"?[V]:V,Ie=!!document.queryCommandSupported;return G.forEach(function(Ut){Ie=Ie&&!!document.queryCommandSupported(Ut)}),Ie}}]),L}(s()),ki=Ci},828:function(o){var n=9;if(typeof Element!="undefined"&&!Element.prototype.matches){var i=Element.prototype;i.matches=i.matchesSelector||i.mozMatchesSelector||i.msMatchesSelector||i.oMatchesSelector||i.webkitMatchesSelector}function a(s,c){for(;s&&s.nodeType!==n;){if(typeof s.matches=="function"&&s.matches(c))return s;s=s.parentNode}}o.exports=a},438:function(o,n,i){var a=i(828);function s(l,f,u,h,v){var b=p.apply(this,arguments);return l.addEventListener(u,b,v),{destroy:function(){l.removeEventListener(u,b,v)}}}function c(l,f,u,h,v){return typeof l.addEventListener=="function"?s.apply(null,arguments):typeof u=="function"?s.bind(null,document).apply(null,arguments):(typeof l=="string"&&(l=document.querySelectorAll(l)),Array.prototype.map.call(l,function(b){return s(b,f,u,h,v)}))}function p(l,f,u,h){return function(v){v.delegateTarget=a(v.target,f),v.delegateTarget&&h.call(l,v)}}o.exports=c},879:function(o,n){n.node=function(i){return i!==void 0&&i instanceof HTMLElement&&i.nodeType===1},n.nodeList=function(i){var a=Object.prototype.toString.call(i);return i!==void 0&&(a==="[object NodeList]"||a==="[object HTMLCollection]")&&"length"in i&&(i.length===0||n.node(i[0]))},n.string=function(i){return typeof i=="string"||i instanceof String},n.fn=function(i){var a=Object.prototype.toString.call(i);return a==="[object Function]"}},370:function(o,n,i){var a=i(879),s=i(438);function c(u,h,v){if(!u&&!h&&!v)throw new Error("Missing required arguments");if(!a.string(h))throw new TypeError("Second argument must be a String");if(!a.fn(v))throw new TypeError("Third argument must be a Function");if(a.node(u))return p(u,h,v);if(a.nodeList(u))return l(u,h,v);if(a.string(u))return f(u,h,v);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList")}function p(u,h,v){return u.addEventListener(h,v),{destroy:function(){u.removeEventListener(h,v)}}}function l(u,h,v){return Array.prototype.forEach.call(u,function(b){b.addEventListener(h,v)}),{destroy:function(){Array.prototype.forEach.call(u,function(b){b.removeEventListener(h,v)})}}}function f(u,h,v){return s(document.body,u,h,v)}o.exports=c},817:function(o){function n(i){var a;if(i.nodeName==="SELECT")i.focus(),a=i.value;else if(i.nodeName==="INPUT"||i.nodeName==="TEXTAREA"){var s=i.hasAttribute("readonly");s||i.setAttribute("readonly",""),i.select(),i.setSelectionRange(0,i.value.length),s||i.removeAttribute("readonly"),a=i.value}else{i.hasAttribute("contenteditable")&&i.focus();var c=window.getSelection(),p=document.createRange();p.selectNodeContents(i),c.removeAllRanges(),c.addRange(p),a=c.toString()}return a}o.exports=n},279:function(o){function n(){}n.prototype={on:function(i,a,s){var c=this.e||(this.e={});return(c[i]||(c[i]=[])).push({fn:a,ctx:s}),this},once:function(i,a,s){var c=this;function p(){c.off(i,p),a.apply(s,arguments)}return p._=a,this.on(i,p,s)},emit:function(i){var a=[].slice.call(arguments,1),s=((this.e||(this.e={}))[i]||[]).slice(),c=0,p=s.length;for(c;c{"use strict";var za=/["'&<>]/;Xn.exports=qa;function qa(e){var t=""+e,r=za.exec(t);if(!r)return t;var o,n="",i=0,a=0;for(i=r.index;i0&&i[i.length-1])&&(p[0]===6||p[0]===2)){r=0;continue}if(p[0]===3&&(!i||p[1]>i[0]&&p[1]=e.length&&(e=void 0),{value:e&&e[o++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")}function K(e,t){var r=typeof Symbol=="function"&&e[Symbol.iterator];if(!r)return e;var o=r.call(e),n,i=[],a;try{for(;(t===void 0||t-- >0)&&!(n=o.next()).done;)i.push(n.value)}catch(s){a={error:s}}finally{try{n&&!n.done&&(r=o.return)&&r.call(o)}finally{if(a)throw a.error}}return i}function Q(e,t,r){if(r||arguments.length===2)for(var o=0,n=t.length,i;o1||s(u,h)})})}function s(u,h){try{c(o[u](h))}catch(v){f(i[0][3],v)}}function c(u){u.value instanceof ct?Promise.resolve(u.value.v).then(p,l):f(i[0][2],u)}function p(u){s("next",u)}function l(u){s("throw",u)}function f(u,h){u(h),i.shift(),i.length&&s(i[0][0],i[0][1])}}function bo(e){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var t=e[Symbol.asyncIterator],r;return t?t.call(e):(e=typeof Te=="function"?Te(e):e[Symbol.iterator](),r={},o("next"),o("throw"),o("return"),r[Symbol.asyncIterator]=function(){return this},r);function o(i){r[i]=e[i]&&function(a){return new Promise(function(s,c){a=e[i](a),n(s,c,a.done,a.value)})}}function n(i,a,s,c){Promise.resolve(c).then(function(p){i({value:p,done:s})},a)}}function k(e){return typeof e=="function"}function ut(e){var t=function(o){Error.call(o),o.stack=new Error().stack},r=e(t);return r.prototype=Object.create(Error.prototype),r.prototype.constructor=r,r}var qt=ut(function(e){return function(r){e(this),this.message=r?r.length+` errors occurred during unsubscription: +`+r.map(function(o,n){return n+1+") "+o.toString()}).join(` + `):"",this.name="UnsubscriptionError",this.errors=r}});function Be(e,t){if(e){var r=e.indexOf(t);0<=r&&e.splice(r,1)}}var De=function(){function e(t){this.initialTeardown=t,this.closed=!1,this._parentage=null,this._finalizers=null}return e.prototype.unsubscribe=function(){var t,r,o,n,i;if(!this.closed){this.closed=!0;var a=this._parentage;if(a)if(this._parentage=null,Array.isArray(a))try{for(var s=Te(a),c=s.next();!c.done;c=s.next()){var p=c.value;p.remove(this)}}catch(b){t={error:b}}finally{try{c&&!c.done&&(r=s.return)&&r.call(s)}finally{if(t)throw t.error}}else a.remove(this);var l=this.initialTeardown;if(k(l))try{l()}catch(b){i=b instanceof qt?b.errors:[b]}var f=this._finalizers;if(f){this._finalizers=null;try{for(var u=Te(f),h=u.next();!h.done;h=u.next()){var v=h.value;try{vo(v)}catch(b){i=i!=null?i:[],b instanceof qt?i=Q(Q([],K(i)),K(b.errors)):i.push(b)}}}catch(b){o={error:b}}finally{try{h&&!h.done&&(n=u.return)&&n.call(u)}finally{if(o)throw o.error}}}if(i)throw new qt(i)}},e.prototype.add=function(t){var r;if(t&&t!==this)if(this.closed)vo(t);else{if(t instanceof e){if(t.closed||t._hasParent(this))return;t._addParent(this)}(this._finalizers=(r=this._finalizers)!==null&&r!==void 0?r:[]).push(t)}},e.prototype._hasParent=function(t){var r=this._parentage;return r===t||Array.isArray(r)&&r.includes(t)},e.prototype._addParent=function(t){var r=this._parentage;this._parentage=Array.isArray(r)?(r.push(t),r):r?[r,t]:t},e.prototype._removeParent=function(t){var r=this._parentage;r===t?this._parentage=null:Array.isArray(r)&&Be(r,t)},e.prototype.remove=function(t){var r=this._finalizers;r&&Be(r,t),t instanceof e&&t._removeParent(this)},e.EMPTY=function(){var t=new e;return t.closed=!0,t}(),e}();var Cr=De.EMPTY;function Kt(e){return e instanceof De||e&&"closed"in e&&k(e.remove)&&k(e.add)&&k(e.unsubscribe)}function vo(e){k(e)?e():e.unsubscribe()}var Fe={onUnhandledError:null,onStoppedNotification:null,Promise:void 0,useDeprecatedSynchronousErrorHandling:!1,useDeprecatedNextContext:!1};var dt={setTimeout:function(e,t){for(var r=[],o=2;o0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(r){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,r)},t.prototype._subscribe=function(r){return this._throwIfClosed(),this._checkFinalizedStatuses(r),this._innerSubscribe(r)},t.prototype._innerSubscribe=function(r){var o=this,n=this,i=n.hasError,a=n.isStopped,s=n.observers;return i||a?Cr:(this.currentObservers=null,s.push(r),new De(function(){o.currentObservers=null,Be(s,r)}))},t.prototype._checkFinalizedStatuses=function(r){var o=this,n=o.hasError,i=o.thrownError,a=o.isStopped;n?r.error(i):a&&r.complete()},t.prototype.asObservable=function(){var r=new D;return r.source=this,r},t.create=function(r,o){return new Oo(r,o)},t}(D);var Oo=function(e){me(t,e);function t(r,o){var n=e.call(this)||this;return n.destination=r,n.source=o,n}return t.prototype.next=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.next)===null||n===void 0||n.call(o,r)},t.prototype.error=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.error)===null||n===void 0||n.call(o,r)},t.prototype.complete=function(){var r,o;(o=(r=this.destination)===null||r===void 0?void 0:r.complete)===null||o===void 0||o.call(r)},t.prototype._subscribe=function(r){var o,n;return(n=(o=this.source)===null||o===void 0?void 0:o.subscribe(r))!==null&&n!==void 0?n:Cr},t}(w);var _t={now:function(){return(_t.delegate||Date).now()},delegate:void 0};var At=function(e){me(t,e);function t(r,o,n){r===void 0&&(r=1/0),o===void 0&&(o=1/0),n===void 0&&(n=_t);var i=e.call(this)||this;return i._bufferSize=r,i._windowTime=o,i._timestampProvider=n,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=o===1/0,i._bufferSize=Math.max(1,r),i._windowTime=Math.max(1,o),i}return t.prototype.next=function(r){var o=this,n=o.isStopped,i=o._buffer,a=o._infiniteTimeWindow,s=o._timestampProvider,c=o._windowTime;n||(i.push(r),!a&&i.push(s.now()+c)),this._trimBuffer(),e.prototype.next.call(this,r)},t.prototype._subscribe=function(r){this._throwIfClosed(),this._trimBuffer();for(var o=this._innerSubscribe(r),n=this,i=n._infiniteTimeWindow,a=n._buffer,s=a.slice(),c=0;c0?e.prototype.requestAsyncId.call(this,r,o,n):(r.actions.push(this),r._scheduled||(r._scheduled=vt.requestAnimationFrame(function(){return r.flush(void 0)})))},t.prototype.recycleAsyncId=function(r,o,n){var i;if(n===void 0&&(n=0),n!=null?n>0:this.delay>0)return e.prototype.recycleAsyncId.call(this,r,o,n);var a=r.actions;o!=null&&((i=a[a.length-1])===null||i===void 0?void 0:i.id)!==o&&(vt.cancelAnimationFrame(o),r._scheduled=void 0)},t}(Bt);var _o=function(e){me(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(r){this._active=!0;var o=this._scheduled;this._scheduled=void 0;var n=this.actions,i;r=r||n.shift();do if(i=r.execute(r.state,r.delay))break;while((r=n[0])&&r.id===o&&n.shift());if(this._active=!1,i){for(;(r=n[0])&&r.id===o&&n.shift();)r.unsubscribe();throw i}},t}(Gt);var Se=new _o(Lo);var M=new D(function(e){return e.complete()});function Jt(e){return e&&k(e.schedule)}function Fr(e){return e[e.length-1]}function tt(e){return k(Fr(e))?e.pop():void 0}function Re(e){return Jt(Fr(e))?e.pop():void 0}function Xt(e,t){return typeof Fr(e)=="number"?e.pop():t}var gt=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function Zt(e){return k(e==null?void 0:e.then)}function er(e){return k(e[bt])}function tr(e){return Symbol.asyncIterator&&k(e==null?void 0:e[Symbol.asyncIterator])}function rr(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function qi(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var or=qi();function nr(e){return k(e==null?void 0:e[or])}function ir(e){return ho(this,arguments,function(){var r,o,n,i;return zt(this,function(a){switch(a.label){case 0:r=e.getReader(),a.label=1;case 1:a.trys.push([1,,9,10]),a.label=2;case 2:return[4,ct(r.read())];case 3:return o=a.sent(),n=o.value,i=o.done,i?[4,ct(void 0)]:[3,5];case 4:return[2,a.sent()];case 5:return[4,ct(n)];case 6:return[4,a.sent()];case 7:return a.sent(),[3,2];case 8:return[3,10];case 9:return r.releaseLock(),[7];case 10:return[2]}})})}function ar(e){return k(e==null?void 0:e.getReader)}function P(e){if(e instanceof D)return e;if(e!=null){if(er(e))return Ki(e);if(gt(e))return Qi(e);if(Zt(e))return Yi(e);if(tr(e))return Ao(e);if(nr(e))return Bi(e);if(ar(e))return Gi(e)}throw rr(e)}function Ki(e){return new D(function(t){var r=e[bt]();if(k(r.subscribe))return r.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function Qi(e){return new D(function(t){for(var r=0;r=2;return function(o){return o.pipe(e?y(function(n,i){return e(n,i,o)}):de,he(1),r?je(t):Ko(function(){return new cr}))}}function Vr(e){return e<=0?function(){return M}:g(function(t,r){var o=[];t.subscribe(x(r,function(n){o.push(n),e=2,!0))}function be(e){e===void 0&&(e={});var t=e.connector,r=t===void 0?function(){return new w}:t,o=e.resetOnError,n=o===void 0?!0:o,i=e.resetOnComplete,a=i===void 0?!0:i,s=e.resetOnRefCountZero,c=s===void 0?!0:s;return function(p){var l,f,u,h=0,v=!1,b=!1,U=function(){f==null||f.unsubscribe(),f=void 0},Y=function(){U(),l=u=void 0,v=b=!1},X=function(){var C=l;Y(),C==null||C.unsubscribe()};return g(function(C,et){h++,!b&&!v&&U();var H=u=u!=null?u:r();et.add(function(){h--,h===0&&!b&&!v&&(f=qr(X,c))}),H.subscribe(et),!l&&h>0&&(l=new lt({next:function(B){return H.next(B)},error:function(B){b=!0,U(),f=qr(Y,n,B),H.error(B)},complete:function(){v=!0,U(),f=qr(Y,a),H.complete()}}),P(C).subscribe(l))})(p)}}function qr(e,t){for(var r=[],o=2;oe.next(document)),e}function R(e,t=document){return Array.from(t.querySelectorAll(e))}function I(e,t=document){let r=le(e,t);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return r}function le(e,t=document){return t.querySelector(e)||void 0}function Ue(){return document.activeElement instanceof HTMLElement&&document.activeElement||void 0}var da=S(d(document.body,"focusin"),d(document.body,"focusout")).pipe(Ee(1),z(void 0),m(()=>Ue()||document.body),ee(1));function Et(e){return da.pipe(m(t=>e.contains(t)),te())}function mr(e,t){return S(d(e,"mouseenter").pipe(m(()=>!0)),d(e,"mouseleave").pipe(m(()=>!1))).pipe(t?Ee(t):de,z(!1))}function ze(e){return{x:e.offsetLeft,y:e.offsetTop}}function Jo(e){return S(d(window,"load"),d(window,"resize")).pipe(He(0,Se),m(()=>ze(e)),z(ze(e)))}function fr(e){return{x:e.scrollLeft,y:e.scrollTop}}function it(e){return S(d(e,"scroll"),d(window,"resize")).pipe(He(0,Se),m(()=>fr(e)),z(fr(e)))}function Xo(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let r of t)Xo(e,r)}function O(e,t,...r){let o=document.createElement(e);if(t)for(let n of Object.keys(t))typeof t[n]!="undefined"&&(typeof t[n]!="boolean"?o.setAttribute(n,t[n]):o.setAttribute(n,""));for(let n of r)Xo(o,n);return o}function ur(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function wt(e){let t=O("script",{src:e});return $(()=>(document.head.appendChild(t),S(d(t,"load"),d(t,"error").pipe(E(()=>jr(()=>new ReferenceError(`Invalid script: ${e}`))))).pipe(m(()=>{}),A(()=>document.head.removeChild(t)),he(1))))}var Zo=new w,ha=$(()=>typeof ResizeObserver=="undefined"?wt("https://unpkg.com/resize-observer-polyfill/dist/ResizeObserver.js"):W(void 0)).pipe(m(()=>new ResizeObserver(e=>{for(let t of e)Zo.next(t)})),E(e=>S(Je,W(e)).pipe(A(()=>e.disconnect()))),ee(1));function ve(e){return{width:e.offsetWidth,height:e.offsetHeight}}function Ce(e){return ha.pipe(T(t=>t.observe(e)),E(t=>Zo.pipe(y(({target:r})=>r===e),A(()=>t.unobserve(e)),m(()=>ve(e)))),z(ve(e)))}function Tt(e){return{width:e.scrollWidth,height:e.scrollHeight}}function dr(e){let t=e.parentElement;for(;t&&(e.scrollWidth<=t.scrollWidth&&e.scrollHeight<=t.scrollHeight);)t=(e=t).parentElement;return t?e:void 0}var en=new w,ba=$(()=>W(new IntersectionObserver(e=>{for(let t of e)en.next(t)},{threshold:0}))).pipe(E(e=>S(Je,W(e)).pipe(A(()=>e.disconnect()))),ee(1));function St(e){return ba.pipe(T(t=>t.observe(e)),E(t=>en.pipe(y(({target:r})=>r===e),A(()=>t.unobserve(e)),m(({isIntersecting:r})=>r))))}function tn(e,t=16){return it(e).pipe(m(({y:r})=>{let o=ve(e),n=Tt(e);return r>=n.height-o.height-t}),te())}var hr={drawer:I("[data-md-toggle=drawer]"),search:I("[data-md-toggle=search]")};function rn(e){return hr[e].checked}function Ze(e,t){hr[e].checked!==t&&hr[e].click()}function qe(e){let t=hr[e];return d(t,"change").pipe(m(()=>t.checked),z(t.checked))}function va(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function ga(){return S(d(window,"compositionstart").pipe(m(()=>!0)),d(window,"compositionend").pipe(m(()=>!1))).pipe(z(!1))}function on(){let e=d(window,"keydown").pipe(y(t=>!(t.metaKey||t.ctrlKey)),m(t=>({mode:rn("search")?"search":"global",type:t.key,claim(){t.preventDefault(),t.stopPropagation()}})),y(({mode:t,type:r})=>{if(t==="global"){let o=Ue();if(typeof o!="undefined")return!va(o,r)}return!0}),be());return ga().pipe(E(t=>t?M:e))}function ge(){return new URL(location.href)}function ft(e,t=!1){if(J("navigation.instant")&&!t){let r=O("a",{href:e.href});document.body.appendChild(r),r.click(),r.remove()}else location.href=e.href}function nn(){return new w}function an(){return location.hash.slice(1)}function br(e){let t=O("a",{href:e});t.addEventListener("click",r=>r.stopPropagation()),t.click()}function Br(e){return S(d(window,"hashchange"),e).pipe(m(an),z(an()),y(t=>t.length>0),ee(1))}function sn(e){return Br(e).pipe(m(t=>le(`[id="${t}"]`)),y(t=>typeof t!="undefined"))}function Rt(e){let t=matchMedia(e);return pr(r=>t.addListener(()=>r(t.matches))).pipe(z(t.matches))}function cn(){let e=matchMedia("print");return S(d(window,"beforeprint").pipe(m(()=>!0)),d(window,"afterprint").pipe(m(()=>!1))).pipe(z(e.matches))}function Gr(e,t){return e.pipe(E(r=>r?t():M))}function vr(e,t){return new D(r=>{let o=new XMLHttpRequest;o.open("GET",`${e}`),o.responseType="blob",o.addEventListener("load",()=>{o.status>=200&&o.status<300?(r.next(o.response),r.complete()):r.error(new Error(o.statusText))}),o.addEventListener("error",()=>{r.error(new Error("Network Error"))}),o.addEventListener("abort",()=>{r.error(new Error("Request aborted"))}),typeof(t==null?void 0:t.progress$)!="undefined"&&(o.addEventListener("progress",n=>{t.progress$.next(n.loaded/n.total*100)}),t.progress$.next(5)),o.send()})}function Ke(e,t){return vr(e,t).pipe(E(r=>r.text()),m(r=>JSON.parse(r)),ee(1))}function pn(e,t){let r=new DOMParser;return vr(e,t).pipe(E(o=>o.text()),m(o=>r.parseFromString(o,"text/xml")),ee(1))}function ln(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function mn(){return S(d(window,"scroll",{passive:!0}),d(window,"resize",{passive:!0})).pipe(m(ln),z(ln()))}function fn(){return{width:innerWidth,height:innerHeight}}function un(){return d(window,"resize",{passive:!0}).pipe(m(fn),z(fn()))}function dn(){return Z([mn(),un()]).pipe(m(([e,t])=>({offset:e,size:t})),ee(1))}function gr(e,{viewport$:t,header$:r}){let o=t.pipe(ne("size")),n=Z([o,r]).pipe(m(()=>ze(e)));return Z([r,t,n]).pipe(m(([{height:i},{offset:a,size:s},{x:c,y:p}])=>({offset:{x:a.x-c,y:a.y-p+i},size:s})))}function xa(e){return d(e,"message",t=>t.data)}function ya(e){let t=new w;return t.subscribe(r=>e.postMessage(r)),t}function hn(e,t=new Worker(e)){let r=xa(t),o=ya(t),n=new w;n.subscribe(o);let i=o.pipe(oe(),se(!0));return n.pipe(oe(),Ne(r.pipe(N(i))),be())}var Ea=I("#__config"),Ot=JSON.parse(Ea.textContent);Ot.base=`${new URL(Ot.base,ge())}`;function xe(){return Ot}function J(e){return Ot.features.includes(e)}function _e(e,t){return typeof t!="undefined"?Ot.translations[e].replace("#",t.toString()):Ot.translations[e]}function ke(e,t=document){return I(`[data-md-component=${e}]`,t)}function pe(e,t=document){return R(`[data-md-component=${e}]`,t)}function wa(e){let t=I(".md-typeset > :first-child",e);return d(t,"click",{once:!0}).pipe(m(()=>I(".md-typeset",e)),m(r=>({hash:__md_hash(r.innerHTML)})))}function bn(e){if(!J("announce.dismiss")||!e.childElementCount)return M;if(!e.hidden){let t=I(".md-typeset",e);__md_hash(t.innerHTML)===__md_get("__announce")&&(e.hidden=!0)}return $(()=>{let t=new w;return t.subscribe(({hash:r})=>{e.hidden=!0,__md_set("__announce",r)}),wa(e).pipe(T(r=>t.next(r)),A(()=>t.complete()),m(r=>j({ref:e},r)))})}function Ta(e,{target$:t}){return t.pipe(m(r=>({hidden:r!==e})))}function vn(e,t){let r=new w;return r.subscribe(({hidden:o})=>{e.hidden=o}),Ta(e,t).pipe(T(o=>r.next(o)),A(()=>r.complete()),m(o=>j({ref:e},o)))}function Pt(e,t){return t==="inline"?O("div",{class:"md-tooltip md-tooltip--inline",id:e,role:"tooltip"},O("div",{class:"md-tooltip__inner md-typeset"})):O("div",{class:"md-tooltip",id:e,role:"tooltip"},O("div",{class:"md-tooltip__inner md-typeset"}))}function gn(e,t){if(t=t?`${t}_annotation_${e}`:void 0,t){let r=t?`#${t}`:void 0;return O("aside",{class:"md-annotation",tabIndex:0},Pt(t),O("a",{href:r,class:"md-annotation__index",tabIndex:-1},O("span",{"data-md-annotation-id":e})))}else return O("aside",{class:"md-annotation",tabIndex:0},Pt(t),O("span",{class:"md-annotation__index",tabIndex:-1},O("span",{"data-md-annotation-id":e})))}function xn(e){return O("button",{class:"md-code__button",title:_e("clipboard.copy"),"data-clipboard-target":`#${e} > code`,"data-md-type":"copy"})}function yn(){return O("button",{class:"md-code__button",title:"Toggle line selection","data-md-type":"select"})}function En(){return O("nav",{class:"md-code__nav"})}function Jr(e,t){let r=t&2,o=t&1,n=Object.keys(e.terms).filter(c=>!e.terms[c]).reduce((c,p)=>[...c,O("del",null,p)," "],[]).slice(0,-1),i=xe(),a=new URL(e.location,i.base);J("search.highlight")&&a.searchParams.set("h",Object.entries(e.terms).filter(([,c])=>c).reduce((c,[p])=>`${c} ${p}`.trim(),""));let{tags:s}=xe();return O("a",{href:`${a}`,class:"md-search-result__link",tabIndex:-1},O("article",{class:"md-search-result__article md-typeset","data-md-score":e.score.toFixed(2)},r>0&&O("div",{class:"md-search-result__icon md-icon"}),r>0&&O("h1",null,e.title),r<=0&&O("h2",null,e.title),o>0&&e.text.length>0&&e.text,e.tags&&e.tags.map(c=>{let p=s?c in s?`md-tag-icon md-tag--${s[c]}`:"md-tag-icon":"";return O("span",{class:`md-tag ${p}`},c)}),o>0&&n.length>0&&O("p",{class:"md-search-result__terms"},_e("search.result.term.missing"),": ",...n)))}function wn(e){let t=e[0].score,r=[...e],o=xe(),n=r.findIndex(l=>!`${new URL(l.location,o.base)}`.includes("#")),[i]=r.splice(n,1),a=r.findIndex(l=>l.scoreJr(l,1)),...c.length?[O("details",{class:"md-search-result__more"},O("summary",{tabIndex:-1},O("div",null,c.length>0&&c.length===1?_e("search.result.more.one"):_e("search.result.more.other",c.length))),...c.map(l=>Jr(l,1)))]:[]];return O("li",{class:"md-search-result__item"},p)}function Tn(e){return O("ul",{class:"md-source__facts"},Object.entries(e).map(([t,r])=>O("li",{class:`md-source__fact md-source__fact--${t}`},typeof r=="number"?ur(r):r)))}function Xr(e){let t=`tabbed-control tabbed-control--${e}`;return O("div",{class:t,hidden:!0},O("button",{class:"tabbed-button",tabIndex:-1,"aria-hidden":"true"}))}function Sn(e){return O("div",{class:"md-typeset__scrollwrap"},O("div",{class:"md-typeset__table"},e))}function Sa(e){let t=xe(),r=new URL(`../${e.version}/`,t.base);return O("li",{class:"md-version__item"},O("a",{href:`${r}`,class:"md-version__link"},e.title))}function On(e,t){return O("div",{class:"md-version"},O("button",{class:"md-version__current","aria-label":_e("select.version")},t.title),O("ul",{class:"md-version__list"},e.map(Sa)))}var Oa=0;function Ma(e,t){document.body.append(e);let{width:r}=ve(e);e.style.setProperty("--md-tooltip-width",`${r}px`),e.remove();let o=dr(t),n=typeof o!="undefined"?it(o):W({x:0,y:0}),i=S(Et(t),mr(t)).pipe(te());return Z([i,n]).pipe(m(([a,s])=>{let{x:c,y:p}=ze(t),l=ve(t),f=t.closest("table");return f&&t.parentElement&&(c+=f.offsetLeft+t.parentElement.offsetLeft,p+=f.offsetTop+t.parentElement.offsetTop),{active:a,offset:{x:c-s.x+l.width/2-r/2,y:p-s.y+l.height+8}}}))}function Qe(e){let t=e.title;if(!t.length)return M;let r=`__tooltip_${Oa++}`,o=Pt(r,"inline"),n=I(".md-typeset",o);return n.innerHTML=t,$(()=>{let i=new w;return i.subscribe({next({offset:a}){o.style.setProperty("--md-tooltip-x",`${a.x}px`),o.style.setProperty("--md-tooltip-y",`${a.y}px`)},complete(){o.style.removeProperty("--md-tooltip-x"),o.style.removeProperty("--md-tooltip-y")}}),S(i.pipe(y(({active:a})=>a)),i.pipe(Ee(250),y(({active:a})=>!a))).subscribe({next({active:a}){a?(e.insertAdjacentElement("afterend",o),e.setAttribute("aria-describedby",r),e.removeAttribute("title")):(o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t))},complete(){o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t)}}),i.pipe(He(16,Se)).subscribe(({active:a})=>{o.classList.toggle("md-tooltip--active",a)}),i.pipe($t(125,Se),y(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:a})=>a)).subscribe({next(a){a?o.style.setProperty("--md-tooltip-0",`${-a}px`):o.style.removeProperty("--md-tooltip-0")},complete(){o.style.removeProperty("--md-tooltip-0")}}),Ma(o,e).pipe(T(a=>i.next(a)),A(()=>i.complete()),m(a=>j({ref:e},a)))}).pipe(Ge(ae))}function La(e,t){let r=$(()=>Z([Jo(e),it(t)])).pipe(m(([{x:o,y:n},i])=>{let{width:a,height:s}=ve(e);return{x:o-i.x+a/2,y:n-i.y+s/2}}));return Et(e).pipe(E(o=>r.pipe(m(n=>({active:o,offset:n})),he(+!o||1/0))))}function Mn(e,t,{target$:r}){let[o,n]=Array.from(e.children);return $(()=>{let i=new w,a=i.pipe(oe(),se(!0));return i.subscribe({next({offset:s}){e.style.setProperty("--md-tooltip-x",`${s.x}px`),e.style.setProperty("--md-tooltip-y",`${s.y}px`)},complete(){e.style.removeProperty("--md-tooltip-x"),e.style.removeProperty("--md-tooltip-y")}}),St(e).pipe(N(a)).subscribe(s=>{e.toggleAttribute("data-md-visible",s)}),S(i.pipe(y(({active:s})=>s)),i.pipe(Ee(250),y(({active:s})=>!s))).subscribe({next({active:s}){s?e.prepend(o):o.remove()},complete(){e.prepend(o)}}),i.pipe(He(16,Se)).subscribe(({active:s})=>{o.classList.toggle("md-tooltip--active",s)}),i.pipe($t(125,Se),y(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:s})=>s)).subscribe({next(s){s?e.style.setProperty("--md-tooltip-0",`${-s}px`):e.style.removeProperty("--md-tooltip-0")},complete(){e.style.removeProperty("--md-tooltip-0")}}),d(n,"click").pipe(N(a),y(s=>!(s.metaKey||s.ctrlKey))).subscribe(s=>{s.stopPropagation(),s.preventDefault()}),d(n,"mousedown").pipe(N(a),ie(i)).subscribe(([s,{active:c}])=>{var p;if(s.button!==0||s.metaKey||s.ctrlKey)s.preventDefault();else if(c){s.preventDefault();let l=e.parentElement.closest(".md-annotation");l instanceof HTMLElement?l.focus():(p=Ue())==null||p.blur()}}),r.pipe(N(a),y(s=>s===o),Xe(125)).subscribe(()=>e.focus()),La(e,t).pipe(T(s=>i.next(s)),A(()=>i.complete()),m(s=>j({ref:e},s)))})}function _a(e){let t=xe();if(e.tagName!=="CODE")return[e];let r=[".c",".c1",".cm"];if(typeof t.annotate!="undefined"){let o=e.closest("[class|=language]");if(o)for(let n of Array.from(o.classList)){if(!n.startsWith("language-"))continue;let[,i]=n.split("-");i in t.annotate&&r.push(...t.annotate[i])}}return R(r.join(", "),e)}function Aa(e){let t=[];for(let r of _a(e)){let o=[],n=document.createNodeIterator(r,NodeFilter.SHOW_TEXT);for(let i=n.nextNode();i;i=n.nextNode())o.push(i);for(let i of o){let a;for(;a=/(\(\d+\))(!)?/.exec(i.textContent);){let[,s,c]=a;if(typeof c=="undefined"){let p=i.splitText(a.index);i=p.splitText(s.length),t.push(p)}else{i.textContent=s,t.push(i);break}}}}return t}function Ln(e,t){t.append(...Array.from(e.childNodes))}function xr(e,t,{target$:r,print$:o}){let n=t.closest("[id]"),i=n==null?void 0:n.id,a=new Map;for(let s of Aa(t)){let[,c]=s.textContent.match(/\((\d+)\)/);le(`:scope > li:nth-child(${c})`,e)&&(a.set(c,gn(c,i)),s.replaceWith(a.get(c)))}return a.size===0?M:$(()=>{let s=new w,c=s.pipe(oe(),se(!0)),p=[];for(let[l,f]of a)p.push([I(".md-typeset",f),I(`:scope > li:nth-child(${l})`,e)]);return o.pipe(N(c)).subscribe(l=>{e.hidden=!l,e.classList.toggle("md-annotation-list",l);for(let[f,u]of p)l?Ln(f,u):Ln(u,f)}),S(...[...a].map(([,l])=>Mn(l,t,{target$:r}))).pipe(A(()=>s.complete()),be())})}function _n(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return _n(t)}}function An(e,t){return $(()=>{let r=_n(e);return typeof r!="undefined"?xr(r,e,t):M})}var kn=Vt(eo());var Ca=0,Cn=S(d(window,"keydown").pipe(m(()=>!0)),S(d(window,"keyup"),d(window,"contextmenu")).pipe(m(()=>!1))).pipe(z(!1),ee(1));function Hn(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return Hn(t)}}function ka(e){return Ce(e).pipe(m(({width:t})=>({scrollable:Tt(e).width>t})),ne("scrollable"))}function $n(e,t){let{matches:r}=matchMedia("(hover)"),o=$(()=>{let n=new w,i=n.pipe(Vr(1));n.subscribe(({scrollable:u})=>{u&&r?e.setAttribute("tabindex","0"):e.removeAttribute("tabindex")});let a=Ca++,s=[],c=e.closest("pre");c.id=`__code_${a}`;let p=[],l=e.closest(".highlight");if(l instanceof HTMLElement){let u=Hn(l);if(typeof u!="undefined"&&(l.classList.contains("annotate")||J("content.code.annotate"))){let h=xr(u,e,t);p.push(Ce(l).pipe(N(i),m(({width:v,height:b})=>v&&b),te(),E(v=>v?h:M)))}}let f=R(":scope > span[id]",e);if(f.length&&(e.classList.add("md-code__content"),e.closest(".select")||J("content.code.select")&&!e.closest(".no-select"))){let u=+f[0].id.split("-").pop(),h=yn();s.push(h),J("content.tooltips")&&p.push(Qe(h));let v=d(h,"click").pipe(Ht(H=>!H,!1),T(()=>h.blur()),be());v.subscribe(H=>{h.classList.toggle("md-code__button--active",H)});let b=fe(f).pipe(re(H=>mr(H).pipe(m(B=>[H,B]))));v.pipe(E(H=>H?b:M)).subscribe(([H,B])=>{let ce=le(".hll.select",H);if(ce&&!B)ce.replaceWith(...Array.from(ce.childNodes));else if(!ce&&B){let ue=document.createElement("span");ue.className="hll select",ue.append(...Array.from(H.childNodes).slice(1)),H.append(ue)}});let U=fe(f).pipe(re(H=>d(H,"mousedown").pipe(T(B=>B.preventDefault()),m(()=>H)))),Y=v.pipe(E(H=>H?U:M),ie(Cn),m(([H,B])=>{var ue;let ce=f.indexOf(H)+u;if(B===!1)return[ce,ce];{let we=R(".hll",e).map(Ye=>f.indexOf(Ye.parentElement)+u);return(ue=window.getSelection())==null||ue.removeAllRanges(),[Math.min(ce,...we),Math.max(ce,...we)]}})),X=Br(M).pipe(y(H=>H.startsWith(`__codelineno-${a}-`)));X.subscribe(H=>{let[,,B]=H.split("-"),ce=B.split(":").map(we=>+we-u+1);ce.length===1&&ce.push(ce[0]);for(let we of R(".hll:not(.select)",e))we.replaceWith(...Array.from(we.childNodes));let ue=f.slice(ce[0]-1,ce[1]);for(let we of ue){let Ye=document.createElement("span");Ye.className="hll",Ye.append(...Array.from(we.childNodes).slice(1)),we.append(Ye)}}),X.pipe(he(1),Oe(ae)).subscribe(H=>{if(H.includes(":")){let B=document.getElementById(H.split(":")[0]);B&&setTimeout(()=>{let ce=B,ue=-(48+16);for(;ce!==document.body;)ue+=ce.offsetTop,ce=ce.offsetParent;window.scrollTo({top:ue})},1)}});let et=fe(R('a[href^="#__codelineno"]',l)).pipe(re(H=>d(H,"click").pipe(T(B=>B.preventDefault()),m(()=>H)))).pipe(N(i),ie(Cn),m(([H,B])=>{let ue=+I(`[id="${H.hash.slice(1)}"]`).parentElement.id.split("-").pop();if(B===!1)return[ue,ue];{let we=R(".hll",e).map(Ye=>+Ye.parentElement.id.split("-").pop());return[Math.min(ue,...we),Math.max(ue,...we)]}}));S(Y,et).subscribe(H=>{let B=`#__codelineno-${a}-`;H[0]===H[1]?B+=H[0]:B+=`${H[0]}:${H[1]}`,history.replaceState({},"",B),window.dispatchEvent(new HashChangeEvent("hashchange",{newURL:window.location.origin+window.location.pathname+B,oldURL:window.location.href}))})}if(kn.default.isSupported()&&(e.closest(".copy")||J("content.code.copy")&&!e.closest(".no-copy"))){let u=xn(c.id);s.push(u),J("content.tooltips")&&p.push(Qe(u))}if(s.length){let u=En();u.append(...s),c.insertBefore(u,e)}return ka(e).pipe(T(u=>n.next(u)),A(()=>n.complete()),m(u=>j({ref:e},u)),Ne(...p))});return J("content.lazy")?St(e).pipe(y(n=>n),he(1),E(()=>o)):o}function Ha(e,{target$:t,print$:r}){let o=!0;return S(t.pipe(m(n=>n.closest("details:not([open])")),y(n=>e===n),m(()=>({action:"open",reveal:!0}))),r.pipe(y(n=>n||!o),T(()=>o=e.open),m(n=>({action:n?"open":"close"}))))}function Rn(e,t){return $(()=>{let r=new w;return r.subscribe(({action:o,reveal:n})=>{e.toggleAttribute("open",o==="open"),n&&e.scrollIntoView()}),Ha(e,t).pipe(T(o=>r.next(o)),A(()=>r.complete()),m(o=>j({ref:e},o)))})}var Pn=".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel rect,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel rect{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}";var to,Ra=0;function Pa(){return typeof mermaid=="undefined"||mermaid instanceof Element?wt("https://unpkg.com/mermaid@9.4.3/dist/mermaid.min.js"):W(void 0)}function In(e){return e.classList.remove("mermaid"),to||(to=Pa().pipe(T(()=>mermaid.initialize({startOnLoad:!1,themeCSS:Pn,sequence:{actorFontSize:"16px",messageFontSize:"16px",noteFontSize:"16px"}})),m(()=>{}),ee(1))),to.subscribe(()=>{e.classList.add("mermaid");let t=`__mermaid_${Ra++}`,r=O("div",{class:"mermaid"}),o=e.textContent;mermaid.mermaidAPI.render(t,o,(n,i)=>{let a=r.attachShadow({mode:"closed"});a.innerHTML=n,e.replaceWith(r),i==null||i(a)})}),to.pipe(m(()=>({ref:e})))}var Fn=O("table");function jn(e){return e.replaceWith(Fn),Fn.replaceWith(Sn(e)),W({ref:e})}function Ia(e){let t=e.find(r=>r.checked)||e[0];return S(...e.map(r=>d(r,"change").pipe(m(()=>I(`label[for="${r.id}"]`))))).pipe(z(I(`label[for="${t.id}"]`)),m(r=>({active:r})))}function Wn(e,{viewport$:t,target$:r}){let o=I(".tabbed-labels",e),n=R(":scope > input",e),i=Xr("prev");e.append(i);let a=Xr("next");return e.append(a),$(()=>{let s=new w,c=s.pipe(oe(),se(!0));Z([s,Ce(e)]).pipe(N(c),He(1,Se)).subscribe({next([{active:p},l]){let f=ze(p),{width:u}=ve(p);e.style.setProperty("--md-indicator-x",`${f.x}px`),e.style.setProperty("--md-indicator-width",`${u}px`);let h=fr(o);(f.xh.x+l.width)&&o.scrollTo({left:Math.max(0,f.x-16),behavior:"smooth"})},complete(){e.style.removeProperty("--md-indicator-x"),e.style.removeProperty("--md-indicator-width")}}),Z([it(o),Ce(o)]).pipe(N(c)).subscribe(([p,l])=>{let f=Tt(o);i.hidden=p.x<16,a.hidden=p.x>f.width-l.width-16}),S(d(i,"click").pipe(m(()=>-1)),d(a,"click").pipe(m(()=>1))).pipe(N(c)).subscribe(p=>{let{width:l}=ve(o);o.scrollBy({left:l*p,behavior:"smooth"})}),r.pipe(N(c),y(p=>n.includes(p))).subscribe(p=>p.click()),o.classList.add("tabbed-labels--linked");for(let p of n){let l=I(`label[for="${p.id}"]`);l.replaceChildren(O("a",{href:`#${l.htmlFor}`,tabIndex:-1},...Array.from(l.childNodes))),d(l.firstElementChild,"click").pipe(N(c),y(f=>!(f.metaKey||f.ctrlKey)),T(f=>{f.preventDefault(),f.stopPropagation()})).subscribe(()=>{history.replaceState({},"",`#${l.htmlFor}`),l.click()})}return J("content.tabs.link")&&s.pipe(Le(1),ie(t)).subscribe(([{active:p},{offset:l}])=>{let f=p.innerText.trim();if(p.hasAttribute("data-md-switching"))p.removeAttribute("data-md-switching");else{let u=e.offsetTop-l.y;for(let v of R("[data-tabs]"))for(let b of R(":scope > input",v)){let U=I(`label[for="${b.id}"]`);if(U!==p&&U.innerText.trim()===f){U.setAttribute("data-md-switching",""),b.click();break}}window.scrollTo({top:e.offsetTop-u});let h=__md_get("__tabs")||[];__md_set("__tabs",[...new Set([f,...h])])}}),s.pipe(N(c)).subscribe(()=>{for(let p of R("audio, video",e))p.pause()}),Ia(n).pipe(T(p=>s.next(p)),A(()=>s.complete()),m(p=>j({ref:e},p)))}).pipe(Ge(ae))}function Nn(e,{viewport$:t,target$:r,print$:o}){return S(...R(".annotate:not(.highlight)",e).map(n=>An(n,{target$:r,print$:o})),...R("pre:not(.mermaid) > code",e).map(n=>$n(n,{target$:r,print$:o})),...R("pre.mermaid",e).map(n=>In(n)),...R("table:not([class])",e).map(n=>jn(n)),...R("details",e).map(n=>Rn(n,{target$:r,print$:o})),...R("[data-tabs]",e).map(n=>Wn(n,{viewport$:t,target$:r})),...R("[title]",e).filter(()=>J("content.tooltips")).map(n=>Qe(n)))}function Fa(e,{alert$:t}){return t.pipe(E(r=>S(W(!0),W(!1).pipe(Xe(2e3))).pipe(m(o=>({message:r,active:o})))))}function Un(e,t){let r=I(".md-typeset",e);return $(()=>{let o=new w;return o.subscribe(({message:n,active:i})=>{e.classList.toggle("md-dialog--active",i),r.textContent=n}),Fa(e,t).pipe(T(n=>o.next(n)),A(()=>o.complete()),m(n=>j({ref:e},n)))})}function ja({viewport$:e}){if(!J("header.autohide"))return W(!1);let t=e.pipe(m(({offset:{y:n}})=>n),Pe(2,1),m(([n,i])=>[nMath.abs(i-n.y)>100),m(([,[n]])=>n),te()),o=qe("search");return Z([e,o]).pipe(m(([{offset:n},i])=>n.y>400&&!i),te(),E(n=>n?r:W(!1)),z(!1))}function Dn(e,t){return $(()=>Z([Ce(e),ja(t)])).pipe(m(([{height:r},o])=>({height:r,hidden:o})),te((r,o)=>r.height===o.height&&r.hidden===o.hidden),ee(1))}function Vn(e,{header$:t,main$:r}){return $(()=>{let o=new w,n=o.pipe(oe(),se(!0));o.pipe(ne("active"),nt(t)).subscribe(([{active:a},{hidden:s}])=>{e.classList.toggle("md-header--shadow",a&&!s),e.hidden=s});let i=fe(R("[title]",e)).pipe(y(()=>J("content.tooltips")),re(a=>Qe(a)));return r.subscribe(o),t.pipe(N(n),m(a=>j({ref:e},a)),Ne(i.pipe(N(n))))})}function Wa(e,{viewport$:t,header$:r}){return gr(e,{viewport$:t,header$:r}).pipe(m(({offset:{y:o}})=>{let{height:n}=ve(e);return{active:o>=n}}),ne("active"))}function zn(e,t){return $(()=>{let r=new w;r.subscribe({next({active:n}){e.classList.toggle("md-header__title--active",n)},complete(){e.classList.remove("md-header__title--active")}});let o=le(".md-content h1");return typeof o=="undefined"?M:Wa(o,t).pipe(T(n=>r.next(n)),A(()=>r.complete()),m(n=>j({ref:e},n)))})}function qn(e,{viewport$:t,header$:r}){let o=r.pipe(m(({height:i})=>i),te()),n=o.pipe(E(()=>Ce(e).pipe(m(({height:i})=>({top:e.offsetTop,bottom:e.offsetTop+i})),ne("bottom"))));return Z([o,n,t]).pipe(m(([i,{top:a,bottom:s},{offset:{y:c},size:{height:p}}])=>(p=Math.max(0,p-Math.max(0,a-c,i)-Math.max(0,p+c-s)),{offset:a-i,height:p,active:a-i<=c})),te((i,a)=>i.offset===a.offset&&i.height===a.height&&i.active===a.active))}function Na(e){let t=__md_get("__palette")||{index:e.findIndex(r=>matchMedia(r.getAttribute("data-md-color-media")).matches)};return W(...e).pipe(re(r=>d(r,"change").pipe(m(()=>r))),z(e[Math.max(0,t.index)]),m(r=>({index:e.indexOf(r),color:{media:r.getAttribute("data-md-color-media"),scheme:r.getAttribute("data-md-color-scheme"),primary:r.getAttribute("data-md-color-primary"),accent:r.getAttribute("data-md-color-accent")}})),ee(1))}function Kn(e){let t=R("input",e),r=O("meta",{name:"theme-color"});document.head.appendChild(r);let o=O("meta",{name:"color-scheme"});document.head.appendChild(o);let n=Rt("(prefers-color-scheme: light)");return $(()=>{let i=new w;return i.subscribe(a=>{if(document.body.setAttribute("data-md-color-switching",""),a.color.media==="(prefers-color-scheme)"){let s=matchMedia("(prefers-color-scheme: light)"),c=document.querySelector(s.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");a.color.scheme=c.getAttribute("data-md-color-scheme"),a.color.primary=c.getAttribute("data-md-color-primary"),a.color.accent=c.getAttribute("data-md-color-accent")}for(let[s,c]of Object.entries(a.color))document.body.setAttribute(`data-md-color-${s}`,c);for(let s=0;s{let a=ke("header"),s=window.getComputedStyle(a);return o.content=s.colorScheme,s.backgroundColor.match(/\d+/g).map(c=>(+c).toString(16).padStart(2,"0")).join("")})).subscribe(a=>r.content=`#${a}`),i.pipe(Oe(ae)).subscribe(()=>{document.body.removeAttribute("data-md-color-switching")}),Na(t).pipe(N(n.pipe(Le(1))),mt(),T(a=>i.next(a)),A(()=>i.complete()),m(a=>j({ref:e},a)))})}function Qn(e,{progress$:t}){return $(()=>{let r=new w;return r.subscribe(({value:o})=>{e.style.setProperty("--md-progress-value",`${o}`)}),t.pipe(T(o=>r.next({value:o})),A(()=>r.complete()),m(o=>({ref:e,value:o})))})}var ro=Vt(eo());function Ua(e){e.setAttribute("data-md-copying","");let t=e.closest("[data-copy]"),r=t?t.getAttribute("data-copy"):e.innerText;return e.removeAttribute("data-md-copying"),r}function Yn({alert$:e}){ro.default.isSupported()&&new D(t=>{new ro.default("[data-clipboard-target], [data-clipboard-text]",{text:r=>r.getAttribute("data-clipboard-text")||Ua(I(r.getAttribute("data-clipboard-target")))}).on("success",r=>t.next(r))}).pipe(T(t=>{t.trigger.focus()}),m(()=>_e("clipboard.copied"))).subscribe(e)}function Da(e){if(e.length<2)return[""];let[t,r]=[...e].sort((n,i)=>n.length-i.length).map(n=>n.replace(/[^/]+$/,"")),o=0;if(t===r)o=t.length;else for(;t.charCodeAt(o)===r.charCodeAt(o);)o++;return e.map(n=>n.replace(t.slice(0,o),""))}function yr(e){let t=__md_get("__sitemap",sessionStorage,e);if(t)return W(t);{let r=xe();return pn(new URL("sitemap.xml",e||r.base)).pipe(m(o=>Da(R("loc",o).map(n=>n.textContent))),Me(()=>M),je([]),T(o=>__md_set("__sitemap",o,sessionStorage,e)))}}function Bn(e,t){if(!(e.target instanceof Element))return M;let r=e.target.closest("a");if(r===null)return M;if(r.target||e.metaKey||e.ctrlKey)return M;let o=new URL(r.href);return o.search=o.hash="",t.includes(`${o}`)?(e.preventDefault(),W(new URL(r.href))):M}function Gn(e){let t=le("[rel=canonical]",e);typeof t!="undefined"&&(t.href=t.href.replace("//localhost:","//127.0.0.1:"));let r=new Map;for(let o of R(":scope > *",e)){let n=o.outerHTML;for(let i of["href","src"]){let a=o.getAttribute(i);if(a===null)continue;let s=new URL(a,t==null?void 0:t.href),c=o.cloneNode();c.setAttribute(i,`${s}`),n=c.outerHTML;break}r.set(n,o)}return r}function Jn({location$:e,viewport$:t,progress$:r}){let o=xe();if(location.protocol==="file:")return M;let n=yr().pipe(m(l=>l.map(f=>`${new URL(f,o.base)}`))),i=d(document.body,"click").pipe(ie(n),E(([l,f])=>Bn(l,f)),be());J("navigation.instant.prefetch")&&S(d(document.body,"mousemove"),d(document.body,"focusin")).pipe(ie(n),E(([l,f])=>Bn(l,f)),Ee(25),Dr(({href:l})=>l),lr(l=>{let f=document.createElement("link");return f.rel="prefetch",f.href=l.toString(),document.head.appendChild(f),d(f,"load").pipe(m(()=>f),he(1))})).subscribe(l=>l.remove()),i.pipe(he(1)).subscribe(()=>{let l=le("link[rel=icon]");typeof l!="undefined"&&(l.href=l.href)}),d(window,"beforeunload").subscribe(()=>{history.scrollRestoration="auto"}),i.pipe(ie(t)).subscribe(([l,{offset:f}])=>{history.scrollRestoration="manual",history.replaceState(f,""),history.pushState(null,"",l)}),i.subscribe(e);let a=e.pipe(z(ge()),ne("pathname"),Le(1),E(l=>vr(l,{progress$:r}).pipe(Me(()=>(ft(l,!0),M))))),s=new DOMParser,c=a.pipe(E(l=>l.text()),E(l=>{let f=s.parseFromString(l,"text/html");for(let b of["[data-md-component=announce]","[data-md-component=container]","[data-md-component=header-topic]","[data-md-component=outdated]","[data-md-component=logo]","[data-md-component=skip]",...J("navigation.tabs.sticky")?["[data-md-component=tabs]"]:[]]){let U=le(b),Y=le(b,f);typeof U!="undefined"&&typeof Y!="undefined"&&U.replaceWith(Y)}let u=Gn(document.head),h=Gn(f.head);for(let[b,U]of h)U.getAttribute("rel")==="stylesheet"||U.hasAttribute("src")||(u.has(b)?u.delete(b):document.head.appendChild(U));for(let b of u.values())b.getAttribute("rel")==="stylesheet"||b.hasAttribute("src")||b.remove();let v=ke("container");return Ve(R("script",v)).pipe(E(b=>{let U=f.createElement("script");if(b.src){for(let Y of b.getAttributeNames())U.setAttribute(Y,b.getAttribute(Y));return b.replaceWith(U),new D(Y=>{U.onload=()=>Y.complete()})}else return U.textContent=b.textContent,b.replaceWith(U),M}),oe(),se(f))}),be());return d(window,"popstate").pipe(m(ge)).subscribe(e),e.pipe(z(ge()),Pe(2,1),y(([l,f])=>l.pathname===f.pathname&&l.hash!==f.hash),m(([,l])=>l)).subscribe(l=>{var f,u;history.state!==null||!l.hash?window.scrollTo(0,(u=(f=history.state)==null?void 0:f.y)!=null?u:0):(history.scrollRestoration="auto",br(l.hash),history.scrollRestoration="manual")}),e.pipe(zr(i),z(ge()),Pe(2,1),y(([l,f])=>l.pathname===f.pathname&&l.hash===f.hash),m(([,l])=>l)).subscribe(l=>{history.scrollRestoration="auto",br(l.hash),history.scrollRestoration="manual",history.back()}),c.pipe(ie(e)).subscribe(([,l])=>{var f,u;history.state!==null||!l.hash?window.scrollTo(0,(u=(f=history.state)==null?void 0:f.y)!=null?u:0):br(l.hash)}),t.pipe(ne("offset"),Ee(100)).subscribe(({offset:l})=>{history.replaceState(l,"")}),c}var ei=Vt(Zn());function ti(e){let t=e.separator.split("|").map(n=>n.replace(/(\(\?[!=<][^)]+\))/g,"").length===0?"\uFFFD":n).join("|"),r=new RegExp(t,"img"),o=(n,i,a)=>`${i}${a}`;return n=>{n=n.replace(/[\s*+\-:~^]+/g," ").trim();let i=new RegExp(`(^|${e.separator}|)(${n.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return a=>(0,ei.default)(a).replace(i,o).replace(/<\/mark>(\s+)]*>/img,"$1")}}function Ft(e){return e.type===1}function Er(e){return e.type===3}function ri(e,t){let r=hn(e);return S(W(location.protocol!=="file:"),qe("search")).pipe(We(o=>o),E(()=>t)).subscribe(({config:o,docs:n})=>r.next({type:0,data:{config:o,docs:n,options:{suggest:J("search.suggest")}}})),r}function oi({document$:e}){let t=xe(),r=Ke(new URL("../versions.json",t.base)).pipe(Me(()=>M)),o=r.pipe(m(n=>{let[,i]=t.base.match(/([^/]+)\/?$/);return n.find(({version:a,aliases:s})=>a===i||s.includes(i))||n[0]}));r.pipe(m(n=>new Map(n.map(i=>[`${new URL(`../${i.version}/`,t.base)}`,i]))),E(n=>d(document.body,"click").pipe(y(i=>!i.metaKey&&!i.ctrlKey),ie(o),E(([i,a])=>{if(i.target instanceof Element){let s=i.target.closest("a");if(s&&!s.target&&n.has(s.href)){let c=s.href;return!i.target.closest(".md-version")&&n.get(c)===a?M:(i.preventDefault(),W(c))}}return M}),E(i=>{let{version:a}=n.get(i);return yr(new URL(i)).pipe(m(s=>{let p=ge().href.replace(t.base,"");return s.includes(p.split("#")[0])?new URL(`../${a}/${p}`,t.base):new URL(i)}))})))).subscribe(n=>ft(n,!0)),Z([r,o]).subscribe(([n,i])=>{I(".md-header__topic").appendChild(On(n,i))}),e.pipe(E(()=>o)).subscribe(n=>{var a;let i=__md_get("__outdated",sessionStorage);if(i===null){i=!0;let s=((a=t.version)==null?void 0:a.default)||"latest";Array.isArray(s)||(s=[s]);e:for(let c of s)for(let p of n.aliases)if(new RegExp(c,"i").test(p)){i=!1;break e}__md_set("__outdated",i,sessionStorage)}if(i)for(let s of pe("outdated"))s.hidden=!1})}function Qa(e,{worker$:t}){let{searchParams:r}=ge();r.has("q")&&(Ze("search",!0),e.value=r.get("q"),e.focus(),qe("search").pipe(We(i=>!i)).subscribe(()=>{let i=ge();i.searchParams.delete("q"),history.replaceState({},"",`${i}`)}));let o=Et(e),n=S(t.pipe(We(Ft)),d(e,"keyup"),o).pipe(m(()=>e.value),te());return Z([n,o]).pipe(m(([i,a])=>({value:i,focus:a})),ee(1))}function ni(e,{worker$:t}){let r=new w,o=r.pipe(oe(),se(!0));Z([t.pipe(We(Ft)),r],(i,a)=>a).pipe(ne("value")).subscribe(({value:i})=>t.next({type:2,data:i})),r.pipe(ne("focus")).subscribe(({focus:i})=>{i&&Ze("search",i)}),d(e.form,"reset").pipe(N(o)).subscribe(()=>e.focus());let n=I("header [for=__search]");return d(n,"click").subscribe(()=>e.focus()),Qa(e,{worker$:t}).pipe(T(i=>r.next(i)),A(()=>r.complete()),m(i=>j({ref:e},i)),ee(1))}function ii(e,{worker$:t,query$:r}){let o=new w,n=tn(e.parentElement).pipe(y(Boolean)),i=e.parentElement,a=I(":scope > :first-child",e),s=I(":scope > :last-child",e);qe("search").subscribe(l=>s.setAttribute("role",l?"list":"presentation")),o.pipe(ie(r),Kr(t.pipe(We(Ft)))).subscribe(([{items:l},{value:f}])=>{switch(l.length){case 0:a.textContent=f.length?_e("search.result.none"):_e("search.result.placeholder");break;case 1:a.textContent=_e("search.result.one");break;default:let u=ur(l.length);a.textContent=_e("search.result.other",u)}});let c=o.pipe(T(()=>s.innerHTML=""),E(({items:l})=>S(W(...l.slice(0,10)),W(...l.slice(10)).pipe(Pe(4),Yr(n),E(([f])=>f)))),m(wn),be());return c.subscribe(l=>s.appendChild(l)),c.pipe(re(l=>{let f=le("details",l);return typeof f=="undefined"?M:d(f,"toggle").pipe(N(o),m(()=>f))})).subscribe(l=>{l.open===!1&&l.offsetTop<=i.scrollTop&&i.scrollTo({top:l.offsetTop})}),t.pipe(y(Er),m(({data:l})=>l)).pipe(T(l=>o.next(l)),A(()=>o.complete()),m(l=>j({ref:e},l)))}function Ya(e,{query$:t}){return t.pipe(m(({value:r})=>{let o=ge();return o.hash="",r=r.replace(/\s+/g,"+").replace(/&/g,"%26").replace(/=/g,"%3D"),o.search=`q=${r}`,{url:o}}))}function ai(e,t){let r=new w,o=r.pipe(oe(),se(!0));return r.subscribe(({url:n})=>{e.setAttribute("data-clipboard-text",e.href),e.href=`${n}`}),d(e,"click").pipe(N(o)).subscribe(n=>n.preventDefault()),Ya(e,t).pipe(T(n=>r.next(n)),A(()=>r.complete()),m(n=>j({ref:e},n)))}function si(e,{worker$:t,keyboard$:r}){let o=new w,n=ke("search-query"),i=S(d(n,"keydown"),d(n,"focus")).pipe(Oe(ae),m(()=>n.value),te());return o.pipe(nt(i),m(([{suggest:s},c])=>{let p=c.split(/([\s-]+)/);if(s!=null&&s.length&&p[p.length-1]){let l=s[s.length-1];l.startsWith(p[p.length-1])&&(p[p.length-1]=l)}else p.length=0;return p})).subscribe(s=>e.innerHTML=s.join("").replace(/\s/g," ")),r.pipe(y(({mode:s})=>s==="search")).subscribe(s=>{switch(s.type){case"ArrowRight":e.innerText.length&&n.selectionStart===n.value.length&&(n.value=e.innerText);break}}),t.pipe(y(Er),m(({data:s})=>s)).pipe(T(s=>o.next(s)),A(()=>o.complete()),m(()=>({ref:e})))}function ci(e,{index$:t,keyboard$:r}){let o=xe();try{let n=ri(o.search,t),i=ke("search-query",e),a=ke("search-result",e);d(e,"click").pipe(y(({target:c})=>c instanceof Element&&!!c.closest("a"))).subscribe(()=>Ze("search",!1)),r.pipe(y(({mode:c})=>c==="search")).subscribe(c=>{let p=Ue();switch(c.type){case"Enter":if(p===i){let l=new Map;for(let f of R(":first-child [href]",a)){let u=f.firstElementChild;l.set(f,parseFloat(u.getAttribute("data-md-score")))}if(l.size){let[[f]]=[...l].sort(([,u],[,h])=>h-u);f.click()}c.claim()}break;case"Escape":case"Tab":Ze("search",!1),i.blur();break;case"ArrowUp":case"ArrowDown":if(typeof p=="undefined")i.focus();else{let l=[i,...R(":not(details) > [href], summary, details[open] [href]",a)],f=Math.max(0,(Math.max(0,l.indexOf(p))+l.length+(c.type==="ArrowUp"?-1:1))%l.length);l[f].focus()}c.claim();break;default:i!==Ue()&&i.focus()}}),r.pipe(y(({mode:c})=>c==="global")).subscribe(c=>{switch(c.type){case"f":case"s":case"/":i.focus(),i.select(),c.claim();break}});let s=ni(i,{worker$:n});return S(s,ii(a,{worker$:n,query$:s})).pipe(Ne(...pe("search-share",e).map(c=>ai(c,{query$:s})),...pe("search-suggest",e).map(c=>si(c,{worker$:n,keyboard$:r}))))}catch(n){return e.hidden=!0,Je}}function pi(e,{index$:t,location$:r}){return Z([t,r.pipe(z(ge()),y(o=>!!o.searchParams.get("h")))]).pipe(m(([o,n])=>ti(o.config)(n.searchParams.get("h"))),m(o=>{var a;let n=new Map,i=document.createNodeIterator(e,NodeFilter.SHOW_TEXT);for(let s=i.nextNode();s;s=i.nextNode())if((a=s.parentElement)!=null&&a.offsetHeight){let c=s.textContent,p=o(c);p.length>c.length&&n.set(s,p)}for(let[s,c]of n){let{childNodes:p}=O("span",null,c);s.replaceWith(...Array.from(p))}return{ref:e,nodes:n}}))}function Ba(e,{viewport$:t,main$:r}){let o=e.closest(".md-grid"),n=o.offsetTop-o.parentElement.offsetTop;return Z([r,t]).pipe(m(([{offset:i,height:a},{offset:{y:s}}])=>(a=a+Math.min(n,Math.max(0,s-i))-n,{height:a,locked:s>=i+n})),te((i,a)=>i.height===a.height&&i.locked===a.locked))}function oo(e,o){var n=o,{header$:t}=n,r=lo(n,["header$"]);let i=I(".md-sidebar__scrollwrap",e),{y:a}=ze(i);return $(()=>{let s=new w,c=s.pipe(oe(),se(!0)),p=s.pipe(He(0,Se));return p.pipe(ie(t)).subscribe({next([{height:l},{height:f}]){i.style.height=`${l-2*a}px`,e.style.top=`${f}px`},complete(){i.style.height="",e.style.top=""}}),p.pipe(We()).subscribe(()=>{for(let l of R(".md-nav__link--active[href]",e)){if(!l.clientHeight)continue;let f=l.closest(".md-sidebar__scrollwrap");if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:h}=ve(f);f.scrollTo({top:u-h/2})}}}),fe(R("label[tabindex]",e)).pipe(re(l=>d(l,"click").pipe(Oe(ae),m(()=>l),N(c)))).subscribe(l=>{let f=I(`[id="${l.htmlFor}"]`);I(`[aria-labelledby="${l.id}"]`).setAttribute("aria-expanded",`${f.checked}`)}),Ba(e,r).pipe(T(l=>s.next(l)),A(()=>s.complete()),m(l=>j({ref:e},l)))})}function li(e,t){if(typeof t!="undefined"){let r=`https://api.github.com/repos/${e}/${t}`;return kt(Ke(`${r}/releases/latest`).pipe(Me(()=>M),m(o=>({version:o.tag_name})),je({})),Ke(r).pipe(Me(()=>M),m(o=>({stars:o.stargazers_count,forks:o.forks_count})),je({}))).pipe(m(([o,n])=>j(j({},o),n)))}else{let r=`https://api.github.com/users/${e}`;return Ke(r).pipe(m(o=>({repositories:o.public_repos})),je({}))}}function mi(e,t){let r=`https://${e}/api/v4/projects/${encodeURIComponent(t)}`;return Ke(r).pipe(Me(()=>M),m(({star_count:o,forks_count:n})=>({stars:o,forks:n})),je({}))}function fi(e){let t=e.match(/^.+github\.com\/([^/]+)\/?([^/]+)?/i);if(t){let[,r,o]=t;return li(r,o)}if(t=e.match(/^.+?([^/]*gitlab[^/]+)\/(.+?)\/?$/i),t){let[,r,o]=t;return mi(r,o)}return M}var Ga;function Ja(e){return Ga||(Ga=$(()=>{let t=__md_get("__source",sessionStorage);if(t)return W(t);if(pe("consent").length){let o=__md_get("__consent");if(!(o&&o.github))return M}return fi(e.href).pipe(T(o=>__md_set("__source",o,sessionStorage)))}).pipe(Me(()=>M),y(t=>Object.keys(t).length>0),m(t=>({facts:t})),ee(1)))}function ui(e){let t=I(":scope > :last-child",e);return $(()=>{let r=new w;return r.subscribe(({facts:o})=>{t.appendChild(Tn(o)),t.classList.add("md-source__repository--active")}),Ja(e).pipe(T(o=>r.next(o)),A(()=>r.complete()),m(o=>j({ref:e},o)))})}function Xa(e,{viewport$:t,header$:r}){return Ce(document.body).pipe(E(()=>gr(e,{header$:r,viewport$:t})),m(({offset:{y:o}})=>({hidden:o>=10})),ne("hidden"))}function di(e,t){return $(()=>{let r=new w;return r.subscribe({next({hidden:o}){e.hidden=o},complete(){e.hidden=!1}}),(J("navigation.tabs.sticky")?W({hidden:!1}):Xa(e,t)).pipe(T(o=>r.next(o)),A(()=>r.complete()),m(o=>j({ref:e},o)))})}function Za(e,{viewport$:t,header$:r}){let o=new Map,n=R("[href^=\\#]",e);for(let s of n){let c=decodeURIComponent(s.hash.substring(1)),p=le(`[id="${c}"]`);typeof p!="undefined"&&o.set(s,p)}let i=r.pipe(ne("height"),m(({height:s})=>{let c=ke("main"),p=I(":scope > :first-child",c);return s+.8*(p.offsetTop-c.offsetTop)}),be());return Ce(document.body).pipe(ne("height"),E(s=>$(()=>{let c=[];return W([...o].reduce((p,[l,f])=>{for(;c.length&&o.get(c[c.length-1]).tagName>=f.tagName;)c.pop();let u=f.offsetTop;for(;!u&&f.parentElement;)f=f.parentElement,u=f.offsetTop;let h=f.offsetParent;for(;h;h=h.offsetParent)u+=h.offsetTop;return p.set([...c=[...c,l]].reverse(),u)},new Map))}).pipe(m(c=>new Map([...c].sort(([,p],[,l])=>p-l))),nt(i),E(([c,p])=>t.pipe(Ht(([l,f],{offset:{y:u},size:h})=>{let v=u+h.height>=Math.floor(s.height);for(;f.length;){let[,b]=f[0];if(b-p=u&&!v)f=[l.pop(),...f];else break}return[l,f]},[[],[...c]]),te((l,f)=>l[0]===f[0]&&l[1]===f[1])))))).pipe(m(([s,c])=>({prev:s.map(([p])=>p),next:c.map(([p])=>p)})),z({prev:[],next:[]}),Pe(2,1),m(([s,c])=>s.prev.length{let i=new w,a=i.pipe(oe(),se(!0));if(i.subscribe(({prev:s,next:c})=>{for(let[p]of c)p.classList.remove("md-nav__link--passed"),p.classList.remove("md-nav__link--active");for(let[p,[l]]of s.entries())l.classList.add("md-nav__link--passed"),l.classList.toggle("md-nav__link--active",p===s.length-1)}),J("toc.follow")){let s=S(t.pipe(Ee(1),m(()=>{})),t.pipe(Ee(250),m(()=>"smooth")));i.pipe(y(({prev:c})=>c.length>0),nt(o.pipe(Oe(ae))),ie(s)).subscribe(([[{prev:c}],p])=>{let[l]=c[c.length-1];if(l.offsetHeight){let f=dr(l);if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:h}=ve(f);f.scrollTo({top:u-h/2,behavior:p})}}})}return J("navigation.tracking")&&t.pipe(N(a),ne("offset"),Ee(250),Le(1),N(n.pipe(Le(1))),mt({delay:250}),ie(i)).subscribe(([,{prev:s}])=>{let c=ge(),p=s[s.length-1];if(p&&p.length){let[l]=p,{hash:f}=new URL(l.href);c.hash!==f&&(c.hash=f,history.replaceState({},"",`${c}`))}else c.hash="",history.replaceState({},"",`${c}`)}),Za(e,{viewport$:t,header$:r}).pipe(T(s=>i.next(s)),A(()=>i.complete()),m(s=>j({ref:e},s)))})}function es(e,{viewport$:t,main$:r,target$:o}){let n=t.pipe(m(({offset:{y:a}})=>a),Pe(2,1),m(([a,s])=>a>s&&s>0),te()),i=r.pipe(m(({active:a})=>a));return Z([i,n]).pipe(m(([a,s])=>!(a&&s)),te(),N(o.pipe(Le(1))),se(!0),mt({delay:250}),m(a=>({hidden:a})))}function bi(e,{viewport$:t,header$:r,main$:o,target$:n}){let i=new w,a=i.pipe(oe(),se(!0));return i.subscribe({next({hidden:s}){e.hidden=s,s?(e.setAttribute("tabindex","-1"),e.blur()):e.removeAttribute("tabindex")},complete(){e.style.top="",e.hidden=!0,e.removeAttribute("tabindex")}}),r.pipe(N(a),ne("height")).subscribe(({height:s})=>{e.style.top=`${s+16}px`}),d(e,"click").subscribe(s=>{s.preventDefault(),window.scrollTo({top:0})}),es(e,{viewport$:t,main$:o,target$:n}).pipe(T(s=>i.next(s)),A(()=>i.complete()),m(s=>j({ref:e},s)))}function vi({document$:e}){e.pipe(E(()=>R(".md-ellipsis")),re(t=>St(t).pipe(N(e.pipe(Le(1))),y(r=>r),m(()=>t),he(1))),y(t=>t.offsetWidth{let r=t.innerText,o=t.closest("a")||t;return o.title=r,Qe(o).pipe(N(e.pipe(Le(1))),A(()=>o.removeAttribute("title")))})).subscribe(),e.pipe(E(()=>R(".md-status")),re(t=>Qe(t))).subscribe()}function gi({document$:e,tablet$:t}){e.pipe(E(()=>R(".md-toggle--indeterminate")),T(r=>{r.indeterminate=!0,r.checked=!1}),re(r=>d(r,"change").pipe(Qr(()=>r.classList.contains("md-toggle--indeterminate")),m(()=>r))),ie(t)).subscribe(([r,o])=>{r.classList.remove("md-toggle--indeterminate"),o&&(r.checked=!1)})}function ts(){return/(iPad|iPhone|iPod)/.test(navigator.userAgent)}function xi({document$:e}){e.pipe(E(()=>R("[data-md-scrollfix]")),T(t=>t.removeAttribute("data-md-scrollfix")),y(ts),re(t=>d(t,"touchstart").pipe(m(()=>t)))).subscribe(t=>{let r=t.scrollTop;r===0?t.scrollTop=1:r+t.offsetHeight===t.scrollHeight&&(t.scrollTop=r-1)})}function yi({viewport$:e,tablet$:t}){Z([qe("search"),t]).pipe(m(([r,o])=>r&&!o),E(r=>W(r).pipe(Xe(r?400:100))),ie(e)).subscribe(([r,{offset:{y:o}}])=>{if(r)document.body.setAttribute("data-md-scrolllock",""),document.body.style.top=`-${o}px`;else{let n=-1*parseInt(document.body.style.top,10);document.body.removeAttribute("data-md-scrolllock"),document.body.style.top="",n&&window.scrollTo(0,n)}})}Object.entries||(Object.entries=function(e){let t=[];for(let r of Object.keys(e))t.push([r,e[r]]);return t});Object.values||(Object.values=function(e){let t=[];for(let r of Object.keys(e))t.push(e[r]);return t});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(e,t){typeof e=="object"?(this.scrollLeft=e.left,this.scrollTop=e.top):(this.scrollLeft=e,this.scrollTop=t)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...e){let t=this.parentNode;if(t){e.length===0&&t.removeChild(this);for(let r=e.length-1;r>=0;r--){let o=e[r];typeof o=="string"?o=document.createTextNode(o):o.parentNode&&o.parentNode.removeChild(o),r?t.insertBefore(this.previousSibling,o):t.replaceChild(o,this)}}}));function rs(){return location.protocol==="file:"?wt(`${new URL("search/search_index.js",no.base)}`).pipe(m(()=>__index),ee(1)):Ke(new URL("search/search_index.json",no.base))}document.documentElement.classList.remove("no-js");document.documentElement.classList.add("js");var st=Go(),Wt=nn(),Mt=sn(Wt),io=on(),$e=dn(),wr=Rt("(min-width: 960px)"),wi=Rt("(min-width: 1220px)"),Ti=cn(),no=xe(),Si=document.forms.namedItem("search")?rs():Je,ao=new w;Yn({alert$:ao});var so=new w;J("navigation.instant")&&Jn({location$:Wt,viewport$:$e,progress$:so}).subscribe(st);var Ei;((Ei=no.version)==null?void 0:Ei.provider)==="mike"&&oi({document$:st});S(Wt,Mt).pipe(Xe(125)).subscribe(()=>{Ze("drawer",!1),Ze("search",!1)});io.pipe(y(({mode:e})=>e==="global")).subscribe(e=>{switch(e.type){case"p":case",":let t=le("link[rel=prev]");typeof t!="undefined"&&ft(t);break;case"n":case".":let r=le("link[rel=next]");typeof r!="undefined"&&ft(r);break;case"Enter":let o=Ue();o instanceof HTMLLabelElement&&o.click()}});vi({document$:st});gi({document$:st,tablet$:wr});xi({document$:st});yi({viewport$:$e,tablet$:wr});var at=Dn(ke("header"),{viewport$:$e}),jt=st.pipe(m(()=>ke("main")),E(e=>qn(e,{viewport$:$e,header$:at})),ee(1)),os=S(...pe("consent").map(e=>vn(e,{target$:Mt})),...pe("dialog").map(e=>Un(e,{alert$:ao})),...pe("header").map(e=>Vn(e,{viewport$:$e,header$:at,main$:jt})),...pe("palette").map(e=>Kn(e)),...pe("progress").map(e=>Qn(e,{progress$:so})),...pe("search").map(e=>ci(e,{index$:Si,keyboard$:io})),...pe("source").map(e=>ui(e))),ns=$(()=>S(...pe("announce").map(e=>bn(e)),...pe("content").map(e=>Nn(e,{viewport$:$e,target$:Mt,print$:Ti})),...pe("content").map(e=>J("search.highlight")?pi(e,{index$:Si,location$:Wt}):M),...pe("header-title").map(e=>zn(e,{viewport$:$e,header$:at})),...pe("sidebar").map(e=>e.getAttribute("data-md-type")==="navigation"?Gr(wi,()=>oo(e,{viewport$:$e,header$:at,main$:jt})):Gr(wr,()=>oo(e,{viewport$:$e,header$:at,main$:jt}))),...pe("tabs").map(e=>di(e,{viewport$:$e,header$:at})),...pe("toc").map(e=>hi(e,{viewport$:$e,header$:at,main$:jt,target$:Mt})),...pe("top").map(e=>bi(e,{viewport$:$e,header$:at,main$:jt,target$:Mt})))),Oi=st.pipe(E(()=>ns),Ne(os),ee(1));Oi.subscribe();window.document$=st;window.location$=Wt;window.target$=Mt;window.keyboard$=io;window.viewport$=$e;window.tablet$=wr;window.screen$=wi;window.print$=Ti;window.alert$=ao;window.progress$=so;window.component$=Oi;})(); diff --git a/assets/javascripts/lunr/min/lunr.ar.min.js b/assets/javascripts/lunr/min/lunr.ar.min.js new file mode 100644 index 00000000..9b06c26c --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.ar.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ar=function(){this.pipeline.reset(),this.pipeline.add(e.ar.trimmer,e.ar.stopWordFilter,e.ar.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ar.stemmer))},e.ar.wordCharacters="ء-ٛٱـ",e.ar.trimmer=e.trimmerSupport.generateTrimmer(e.ar.wordCharacters),e.Pipeline.registerFunction(e.ar.trimmer,"trimmer-ar"),e.ar.stemmer=function(){var e=this;return e.result=!1,e.preRemoved=!1,e.sufRemoved=!1,e.pre={pre1:"ف ك ب و س ل ن ا ي ت",pre2:"ال لل",pre3:"بال وال فال تال كال ولل",pre4:"فبال كبال وبال وكال"},e.suf={suf1:"ه ك ت ن ا ي",suf2:"نك نه ها وك يا اه ون ين تن تم نا وا ان كم كن ني نن ما هم هن تك ته ات يه",suf3:"تين كهم نيه نهم ونه وها يهم ونا ونك وني وهم تكم تنا تها تني تهم كما كها ناه نكم هنا تان يها",suf4:"كموه ناها ونني ونهم تكما تموه تكاه كماه ناكم ناهم نيها وننا"},e.patterns=JSON.parse('{"pt43":[{"pt":[{"c":"ا","l":1}]},{"pt":[{"c":"ا,ت,ن,ي","l":0}],"mPt":[{"c":"ف","l":0,"m":1},{"c":"ع","l":1,"m":2},{"c":"ل","l":2,"m":3}]},{"pt":[{"c":"و","l":2}],"mPt":[{"c":"ف","l":0,"m":0},{"c":"ع","l":1,"m":1},{"c":"ل","l":2,"m":3}]},{"pt":[{"c":"ا","l":2}]},{"pt":[{"c":"ي","l":2}],"mPt":[{"c":"ف","l":0,"m":0},{"c":"ع","l":1,"m":1},{"c":"ا","l":2},{"c":"ل","l":3,"m":3}]},{"pt":[{"c":"م","l":0}]}],"pt53":[{"pt":[{"c":"ت","l":0},{"c":"ا","l":2}]},{"pt":[{"c":"ا,ن,ت,ي","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":0},{"c":"ا","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":3},{"c":"ل","l":3,"m":4},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":0},{"c":"ا","l":3}],"mPt":[{"c":"ف","l":0,"m":1},{"c":"ع","l":1,"m":2},{"c":"ل","l":2,"m":4}]},{"pt":[{"c":"ا","l":3},{"c":"ن","l":4}]},{"pt":[{"c":"ت","l":0},{"c":"ي","l":3}]},{"pt":[{"c":"م","l":0},{"c":"و","l":3}]},{"pt":[{"c":"ا","l":1},{"c":"و","l":3}]},{"pt":[{"c":"و","l":1},{"c":"ا","l":2}]},{"pt":[{"c":"م","l":0},{"c":"ا","l":3}]},{"pt":[{"c":"م","l":0},{"c":"ي","l":3}]},{"pt":[{"c":"ا","l":2},{"c":"ن","l":3}]},{"pt":[{"c":"م","l":0},{"c":"ن","l":1}],"mPt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ف","l":2,"m":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"م","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"م","l":0},{"c":"ا","l":2}]},{"pt":[{"c":"م","l":1},{"c":"ا","l":3}]},{"pt":[{"c":"ي,ت,ا,ن","l":0},{"c":"ت","l":1}],"mPt":[{"c":"ف","l":0,"m":2},{"c":"ع","l":1,"m":3},{"c":"ا","l":2},{"c":"ل","l":3,"m":4}]},{"pt":[{"c":"ت,ي,ا,ن","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":2},{"c":"ي","l":3}]},{"pt":[{"c":"ا,ي,ت,ن","l":0},{"c":"ن","l":1}],"mPt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ف","l":2,"m":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":3},{"c":"ء","l":4}]}],"pt63":[{"pt":[{"c":"ا","l":0},{"c":"ت","l":2},{"c":"ا","l":4}]},{"pt":[{"c":"ا,ت,ن,ي","l":0},{"c":"س","l":1},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ف","l":3,"m":3},{"c":"ع","l":4,"m":4},{"c":"ا","l":5},{"c":"ل","l":6,"m":5}]},{"pt":[{"c":"ا,ن,ت,ي","l":0},{"c":"و","l":3}]},{"pt":[{"c":"م","l":0},{"c":"س","l":1},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ف","l":3,"m":3},{"c":"ع","l":4,"m":4},{"c":"ا","l":5},{"c":"ل","l":6,"m":5}]},{"pt":[{"c":"ي","l":1},{"c":"ي","l":3},{"c":"ا","l":4},{"c":"ء","l":5}]},{"pt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ا","l":4}]}],"pt54":[{"pt":[{"c":"ت","l":0}]},{"pt":[{"c":"ا,ي,ت,ن","l":0}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":2},{"c":"ل","l":3,"m":3},{"c":"ر","l":4,"m":4},{"c":"ا","l":5},{"c":"ر","l":6,"m":4}]},{"pt":[{"c":"م","l":0}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":2},{"c":"ل","l":3,"m":3},{"c":"ر","l":4,"m":4},{"c":"ا","l":5},{"c":"ر","l":6,"m":4}]},{"pt":[{"c":"ا","l":2}]},{"pt":[{"c":"ا","l":0},{"c":"ن","l":2}]}],"pt64":[{"pt":[{"c":"ا","l":0},{"c":"ا","l":4}]},{"pt":[{"c":"م","l":0},{"c":"ت","l":1}]}],"pt73":[{"pt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ا","l":5}]}],"pt75":[{"pt":[{"c":"ا","l":0},{"c":"ا","l":5}]}]}'),e.execArray=["cleanWord","removeDiacritics","cleanAlef","removeStopWords","normalizeHamzaAndAlef","removeStartWaw","removePre432","removeEndTaa","wordCheck"],e.stem=function(){var r=0;for(e.result=!1,e.preRemoved=!1,e.sufRemoved=!1;r=0)return!0},e.normalizeHamzaAndAlef=function(){return e.word=e.word.replace("ؤ","ء"),e.word=e.word.replace("ئ","ء"),e.word=e.word.replace(/([\u0627])\1+/gi,"ا"),!1},e.removeEndTaa=function(){return!(e.word.length>2)||(e.word=e.word.replace(/[\u0627]$/,""),e.word=e.word.replace("ة",""),!1)},e.removeStartWaw=function(){return e.word.length>3&&"و"==e.word[0]&&"و"==e.word[1]&&(e.word=e.word.slice(1)),!1},e.removePre432=function(){var r=e.word;if(e.word.length>=7){var t=new RegExp("^("+e.pre.pre4.split(" ").join("|")+")");e.word=e.word.replace(t,"")}if(e.word==r&&e.word.length>=6){var c=new RegExp("^("+e.pre.pre3.split(" ").join("|")+")");e.word=e.word.replace(c,"")}if(e.word==r&&e.word.length>=5){var l=new RegExp("^("+e.pre.pre2.split(" ").join("|")+")");e.word=e.word.replace(l,"")}return r!=e.word&&(e.preRemoved=!0),!1},e.patternCheck=function(r){for(var t=0;t3){var t=new RegExp("^("+e.pre.pre1.split(" ").join("|")+")");e.word=e.word.replace(t,"")}return r!=e.word&&(e.preRemoved=!0),!1},e.removeSuf1=function(){var r=e.word;if(0==e.sufRemoved&&e.word.length>3){var t=new RegExp("("+e.suf.suf1.split(" ").join("|")+")$");e.word=e.word.replace(t,"")}return r!=e.word&&(e.sufRemoved=!0),!1},e.removeSuf432=function(){var r=e.word;if(e.word.length>=6){var t=new RegExp("("+e.suf.suf4.split(" ").join("|")+")$");e.word=e.word.replace(t,"")}if(e.word==r&&e.word.length>=5){var c=new RegExp("("+e.suf.suf3.split(" ").join("|")+")$");e.word=e.word.replace(c,"")}if(e.word==r&&e.word.length>=4){var l=new RegExp("("+e.suf.suf2.split(" ").join("|")+")$");e.word=e.word.replace(l,"")}return r!=e.word&&(e.sufRemoved=!0),!1},e.wordCheck=function(){for(var r=(e.word,[e.removeSuf432,e.removeSuf1,e.removePre1]),t=0,c=!1;e.word.length>=7&&!e.result&&t=f.limit)return;f.cursor++}for(;!f.out_grouping(w,97,248);){if(f.cursor>=f.limit)return;f.cursor++}d=f.cursor,d=d&&(r=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,e=f.find_among_b(c,32),f.limit_backward=r,e))switch(f.bra=f.cursor,e){case 1:f.slice_del();break;case 2:f.in_grouping_b(p,97,229)&&f.slice_del()}}function t(){var e,r=f.limit-f.cursor;f.cursor>=d&&(e=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,f.find_among_b(l,4)?(f.bra=f.cursor,f.limit_backward=e,f.cursor=f.limit-r,f.cursor>f.limit_backward&&(f.cursor--,f.bra=f.cursor,f.slice_del())):f.limit_backward=e)}function s(){var e,r,i,n=f.limit-f.cursor;if(f.ket=f.cursor,f.eq_s_b(2,"st")&&(f.bra=f.cursor,f.eq_s_b(2,"ig")&&f.slice_del()),f.cursor=f.limit-n,f.cursor>=d&&(r=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,e=f.find_among_b(m,5),f.limit_backward=r,e))switch(f.bra=f.cursor,e){case 1:f.slice_del(),i=f.limit-f.cursor,t(),f.cursor=f.limit-i;break;case 2:f.slice_from("løs")}}function o(){var e;f.cursor>=d&&(e=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,f.out_grouping_b(w,97,248)?(f.bra=f.cursor,u=f.slice_to(u),f.limit_backward=e,f.eq_v_b(u)&&f.slice_del()):f.limit_backward=e)}var a,d,u,c=[new r("hed",-1,1),new r("ethed",0,1),new r("ered",-1,1),new r("e",-1,1),new r("erede",3,1),new r("ende",3,1),new r("erende",5,1),new r("ene",3,1),new r("erne",3,1),new r("ere",3,1),new r("en",-1,1),new r("heden",10,1),new r("eren",10,1),new r("er",-1,1),new r("heder",13,1),new r("erer",13,1),new r("s",-1,2),new r("heds",16,1),new r("es",16,1),new r("endes",18,1),new r("erendes",19,1),new r("enes",18,1),new r("ernes",18,1),new r("eres",18,1),new r("ens",16,1),new r("hedens",24,1),new r("erens",24,1),new r("ers",16,1),new r("ets",16,1),new r("erets",28,1),new r("et",-1,1),new r("eret",30,1)],l=[new r("gd",-1,-1),new r("dt",-1,-1),new r("gt",-1,-1),new r("kt",-1,-1)],m=[new r("ig",-1,1),new r("lig",0,1),new r("elig",1,1),new r("els",-1,1),new r("løst",-1,2)],w=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128],p=[239,254,42,3,0,0,0,0,0,0,0,0,0,0,0,0,16],f=new i;this.setCurrent=function(e){f.setCurrent(e)},this.getCurrent=function(){return f.getCurrent()},this.stem=function(){var r=f.cursor;return e(),f.limit_backward=r,f.cursor=f.limit,n(),f.cursor=f.limit,t(),f.cursor=f.limit,s(),f.cursor=f.limit,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.da.stemmer,"stemmer-da"),e.da.stopWordFilter=e.generateStopWordFilter("ad af alle alt anden at blev blive bliver da de dem den denne der deres det dette dig din disse dog du efter eller en end er et for fra ham han hans har havde have hende hendes her hos hun hvad hvis hvor i ikke ind jeg jer jo kunne man mange med meget men mig min mine mit mod ned noget nogle nu når og også om op os over på selv sig sin sine sit skal skulle som sådan thi til ud under var vi vil ville vor være været".split(" ")),e.Pipeline.registerFunction(e.da.stopWordFilter,"stopWordFilter-da")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.de.min.js b/assets/javascripts/lunr/min/lunr.de.min.js new file mode 100644 index 00000000..f3b5c108 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.de.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `German` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.de=function(){this.pipeline.reset(),this.pipeline.add(e.de.trimmer,e.de.stopWordFilter,e.de.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.de.stemmer))},e.de.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.de.trimmer=e.trimmerSupport.generateTrimmer(e.de.wordCharacters),e.Pipeline.registerFunction(e.de.trimmer,"trimmer-de"),e.de.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,n){return!(!v.eq_s(1,e)||(v.ket=v.cursor,!v.in_grouping(p,97,252)))&&(v.slice_from(r),v.cursor=n,!0)}function i(){for(var r,n,i,s,t=v.cursor;;)if(r=v.cursor,v.bra=r,v.eq_s(1,"ß"))v.ket=v.cursor,v.slice_from("ss");else{if(r>=v.limit)break;v.cursor=r+1}for(v.cursor=t;;)for(n=v.cursor;;){if(i=v.cursor,v.in_grouping(p,97,252)){if(s=v.cursor,v.bra=s,e("u","U",i))break;if(v.cursor=s,e("y","Y",i))break}if(i>=v.limit)return void(v.cursor=n);v.cursor=i+1}}function s(){for(;!v.in_grouping(p,97,252);){if(v.cursor>=v.limit)return!0;v.cursor++}for(;!v.out_grouping(p,97,252);){if(v.cursor>=v.limit)return!0;v.cursor++}return!1}function t(){m=v.limit,l=m;var e=v.cursor+3;0<=e&&e<=v.limit&&(d=e,s()||(m=v.cursor,m=v.limit)return;v.cursor++}}}function c(){return m<=v.cursor}function u(){return l<=v.cursor}function a(){var e,r,n,i,s=v.limit-v.cursor;if(v.ket=v.cursor,(e=v.find_among_b(w,7))&&(v.bra=v.cursor,c()))switch(e){case 1:v.slice_del();break;case 2:v.slice_del(),v.ket=v.cursor,v.eq_s_b(1,"s")&&(v.bra=v.cursor,v.eq_s_b(3,"nis")&&v.slice_del());break;case 3:v.in_grouping_b(g,98,116)&&v.slice_del()}if(v.cursor=v.limit-s,v.ket=v.cursor,(e=v.find_among_b(f,4))&&(v.bra=v.cursor,c()))switch(e){case 1:v.slice_del();break;case 2:if(v.in_grouping_b(k,98,116)){var t=v.cursor-3;v.limit_backward<=t&&t<=v.limit&&(v.cursor=t,v.slice_del())}}if(v.cursor=v.limit-s,v.ket=v.cursor,(e=v.find_among_b(_,8))&&(v.bra=v.cursor,u()))switch(e){case 1:v.slice_del(),v.ket=v.cursor,v.eq_s_b(2,"ig")&&(v.bra=v.cursor,r=v.limit-v.cursor,v.eq_s_b(1,"e")||(v.cursor=v.limit-r,u()&&v.slice_del()));break;case 2:n=v.limit-v.cursor,v.eq_s_b(1,"e")||(v.cursor=v.limit-n,v.slice_del());break;case 3:if(v.slice_del(),v.ket=v.cursor,i=v.limit-v.cursor,!v.eq_s_b(2,"er")&&(v.cursor=v.limit-i,!v.eq_s_b(2,"en")))break;v.bra=v.cursor,c()&&v.slice_del();break;case 4:v.slice_del(),v.ket=v.cursor,e=v.find_among_b(b,2),e&&(v.bra=v.cursor,u()&&1==e&&v.slice_del())}}var d,l,m,h=[new r("",-1,6),new r("U",0,2),new r("Y",0,1),new r("ä",0,3),new r("ö",0,4),new r("ü",0,5)],w=[new r("e",-1,2),new r("em",-1,1),new r("en",-1,2),new r("ern",-1,1),new r("er",-1,1),new r("s",-1,3),new r("es",5,2)],f=[new r("en",-1,1),new r("er",-1,1),new r("st",-1,2),new r("est",2,1)],b=[new r("ig",-1,1),new r("lich",-1,1)],_=[new r("end",-1,1),new r("ig",-1,2),new r("ung",-1,1),new r("lich",-1,3),new r("isch",-1,2),new r("ik",-1,2),new r("heit",-1,3),new r("keit",-1,4)],p=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32,8],g=[117,30,5],k=[117,30,4],v=new n;this.setCurrent=function(e){v.setCurrent(e)},this.getCurrent=function(){return v.getCurrent()},this.stem=function(){var e=v.cursor;return i(),v.cursor=e,t(),v.limit_backward=e,v.cursor=v.limit,a(),v.cursor=v.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.de.stemmer,"stemmer-de"),e.de.stopWordFilter=e.generateStopWordFilter("aber alle allem allen aller alles als also am an ander andere anderem anderen anderer anderes anderm andern anderr anders auch auf aus bei bin bis bist da damit dann das dasselbe dazu daß dein deine deinem deinen deiner deines dem demselben den denn denselben der derer derselbe derselben des desselben dessen dich die dies diese dieselbe dieselben diesem diesen dieser dieses dir doch dort du durch ein eine einem einen einer eines einig einige einigem einigen einiger einiges einmal er es etwas euch euer eure eurem euren eurer eures für gegen gewesen hab habe haben hat hatte hatten hier hin hinter ich ihm ihn ihnen ihr ihre ihrem ihren ihrer ihres im in indem ins ist jede jedem jeden jeder jedes jene jenem jenen jener jenes jetzt kann kein keine keinem keinen keiner keines können könnte machen man manche manchem manchen mancher manches mein meine meinem meinen meiner meines mich mir mit muss musste nach nicht nichts noch nun nur ob oder ohne sehr sein seine seinem seinen seiner seines selbst sich sie sind so solche solchem solchen solcher solches soll sollte sondern sonst um und uns unse unsem unsen unser unses unter viel vom von vor war waren warst was weg weil weiter welche welchem welchen welcher welches wenn werde werden wie wieder will wir wird wirst wo wollen wollte während würde würden zu zum zur zwar zwischen über".split(" ")),e.Pipeline.registerFunction(e.de.stopWordFilter,"stopWordFilter-de")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.du.min.js b/assets/javascripts/lunr/min/lunr.du.min.js new file mode 100644 index 00000000..49a0f3f0 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.du.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Dutch` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");console.warn('[Lunr Languages] Please use the "nl" instead of the "du". The "nl" code is the standard code for Dutch language, and "du" will be removed in the next major versions.'),e.du=function(){this.pipeline.reset(),this.pipeline.add(e.du.trimmer,e.du.stopWordFilter,e.du.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.du.stemmer))},e.du.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.du.trimmer=e.trimmerSupport.generateTrimmer(e.du.wordCharacters),e.Pipeline.registerFunction(e.du.trimmer,"trimmer-du"),e.du.stemmer=function(){var r=e.stemmerSupport.Among,i=e.stemmerSupport.SnowballProgram,n=new function(){function e(){for(var e,r,i,o=C.cursor;;){if(C.bra=C.cursor,e=C.find_among(b,11))switch(C.ket=C.cursor,e){case 1:C.slice_from("a");continue;case 2:C.slice_from("e");continue;case 3:C.slice_from("i");continue;case 4:C.slice_from("o");continue;case 5:C.slice_from("u");continue;case 6:if(C.cursor>=C.limit)break;C.cursor++;continue}break}for(C.cursor=o,C.bra=o,C.eq_s(1,"y")?(C.ket=C.cursor,C.slice_from("Y")):C.cursor=o;;)if(r=C.cursor,C.in_grouping(q,97,232)){if(i=C.cursor,C.bra=i,C.eq_s(1,"i"))C.ket=C.cursor,C.in_grouping(q,97,232)&&(C.slice_from("I"),C.cursor=r);else if(C.cursor=i,C.eq_s(1,"y"))C.ket=C.cursor,C.slice_from("Y"),C.cursor=r;else if(n(r))break}else if(n(r))break}function n(e){return C.cursor=e,e>=C.limit||(C.cursor++,!1)}function o(){_=C.limit,f=_,t()||(_=C.cursor,_<3&&(_=3),t()||(f=C.cursor))}function t(){for(;!C.in_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}for(;!C.out_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}return!1}function s(){for(var e;;)if(C.bra=C.cursor,e=C.find_among(p,3))switch(C.ket=C.cursor,e){case 1:C.slice_from("y");break;case 2:C.slice_from("i");break;case 3:if(C.cursor>=C.limit)return;C.cursor++}}function u(){return _<=C.cursor}function c(){return f<=C.cursor}function a(){var e=C.limit-C.cursor;C.find_among_b(g,3)&&(C.cursor=C.limit-e,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del()))}function l(){var e;w=!1,C.ket=C.cursor,C.eq_s_b(1,"e")&&(C.bra=C.cursor,u()&&(e=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-e,C.slice_del(),w=!0,a())))}function m(){var e;u()&&(e=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-e,C.eq_s_b(3,"gem")||(C.cursor=C.limit-e,C.slice_del(),a())))}function d(){var e,r,i,n,o,t,s=C.limit-C.cursor;if(C.ket=C.cursor,e=C.find_among_b(h,5))switch(C.bra=C.cursor,e){case 1:u()&&C.slice_from("heid");break;case 2:m();break;case 3:u()&&C.out_grouping_b(z,97,232)&&C.slice_del()}if(C.cursor=C.limit-s,l(),C.cursor=C.limit-s,C.ket=C.cursor,C.eq_s_b(4,"heid")&&(C.bra=C.cursor,c()&&(r=C.limit-C.cursor,C.eq_s_b(1,"c")||(C.cursor=C.limit-r,C.slice_del(),C.ket=C.cursor,C.eq_s_b(2,"en")&&(C.bra=C.cursor,m())))),C.cursor=C.limit-s,C.ket=C.cursor,e=C.find_among_b(k,6))switch(C.bra=C.cursor,e){case 1:if(c()){if(C.slice_del(),i=C.limit-C.cursor,C.ket=C.cursor,C.eq_s_b(2,"ig")&&(C.bra=C.cursor,c()&&(n=C.limit-C.cursor,!C.eq_s_b(1,"e")))){C.cursor=C.limit-n,C.slice_del();break}C.cursor=C.limit-i,a()}break;case 2:c()&&(o=C.limit-C.cursor,C.eq_s_b(1,"e")||(C.cursor=C.limit-o,C.slice_del()));break;case 3:c()&&(C.slice_del(),l());break;case 4:c()&&C.slice_del();break;case 5:c()&&w&&C.slice_del()}C.cursor=C.limit-s,C.out_grouping_b(j,73,232)&&(t=C.limit-C.cursor,C.find_among_b(v,4)&&C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-t,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del())))}var f,_,w,b=[new r("",-1,6),new r("á",0,1),new r("ä",0,1),new r("é",0,2),new r("ë",0,2),new r("í",0,3),new r("ï",0,3),new r("ó",0,4),new r("ö",0,4),new r("ú",0,5),new r("ü",0,5)],p=[new r("",-1,3),new r("I",0,2),new r("Y",0,1)],g=[new r("dd",-1,-1),new r("kk",-1,-1),new r("tt",-1,-1)],h=[new r("ene",-1,2),new r("se",-1,3),new r("en",-1,2),new r("heden",2,1),new r("s",-1,3)],k=[new r("end",-1,1),new r("ig",-1,2),new r("ing",-1,1),new r("lijk",-1,3),new r("baar",-1,4),new r("bar",-1,5)],v=[new r("aa",-1,-1),new r("ee",-1,-1),new r("oo",-1,-1),new r("uu",-1,-1)],q=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],j=[1,0,0,17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],z=[17,67,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],C=new i;this.setCurrent=function(e){C.setCurrent(e)},this.getCurrent=function(){return C.getCurrent()},this.stem=function(){var r=C.cursor;return e(),C.cursor=r,o(),C.limit_backward=r,C.cursor=C.limit,d(),C.cursor=C.limit_backward,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.du.stemmer,"stemmer-du"),e.du.stopWordFilter=e.generateStopWordFilter(" aan al alles als altijd andere ben bij daar dan dat de der deze die dit doch doen door dus een eens en er ge geen geweest haar had heb hebben heeft hem het hier hij hoe hun iemand iets ik in is ja je kan kon kunnen maar me meer men met mij mijn moet na naar niet niets nog nu of om omdat onder ons ook op over reeds te tegen toch toen tot u uit uw van veel voor want waren was wat werd wezen wie wil worden wordt zal ze zelf zich zij zijn zo zonder zou".split(" ")),e.Pipeline.registerFunction(e.du.stopWordFilter,"stopWordFilter-du")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.el.min.js b/assets/javascripts/lunr/min/lunr.el.min.js new file mode 100644 index 00000000..ace017bd --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.el.min.js @@ -0,0 +1 @@ +!function(e,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.el=function(){this.pipeline.reset(),void 0===this.searchPipeline&&this.pipeline.add(e.el.trimmer,e.el.normilizer),this.pipeline.add(e.el.stopWordFilter,e.el.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.el.stemmer))},e.el.wordCharacters="A-Za-zΑαΒβΓγΔδΕεΖζΗηΘθΙιΚκΛλΜμΝνΞξΟοΠπΡρΣσςΤτΥυΦφΧχΨψΩωΆάΈέΉήΊίΌόΎύΏώΪΐΫΰΐΰ",e.el.trimmer=e.trimmerSupport.generateTrimmer(e.el.wordCharacters),e.Pipeline.registerFunction(e.el.trimmer,"trimmer-el"),e.el.stemmer=function(){function e(e){return s.test(e)}function t(e){return/[ΑΕΗΙΟΥΩ]$/.test(e)}function r(e){return/[ΑΕΗΙΟΩ]$/.test(e)}function n(n){var s=n;if(n.length<3)return s;if(!e(n))return s;if(i.indexOf(n)>=0)return s;var u=new RegExp("(.*)("+Object.keys(l).join("|")+")$"),o=u.exec(s);return null!==o&&(s=o[1]+l[o[2]]),null!==(o=/^(.+?)(ΑΔΕΣ|ΑΔΩΝ)$/.exec(s))&&(s=o[1],/(ΟΚ|ΜΑΜ|ΜΑΝ|ΜΠΑΜΠ|ΠΑΤΕΡ|ΓΙΑΓΙ|ΝΤΑΝΤ|ΚΥΡ|ΘΕΙ|ΠΕΘΕΡ|ΜΟΥΣΑΜ|ΚΑΠΛΑΜ|ΠΑΡ|ΨΑΡ|ΤΖΟΥΡ|ΤΑΜΠΟΥΡ|ΓΑΛΑΤ|ΦΑΦΛΑΤ)$/.test(o[1])||(s+="ΑΔ")),null!==(o=/^(.+?)(ΕΔΕΣ|ΕΔΩΝ)$/.exec(s))&&(s=o[1],/(ΟΠ|ΙΠ|ΕΜΠ|ΥΠ|ΓΗΠ|ΔΑΠ|ΚΡΑΣΠ|ΜΙΛ)$/.test(o[1])&&(s+="ΕΔ")),null!==(o=/^(.+?)(ΟΥΔΕΣ|ΟΥΔΩΝ)$/.exec(s))&&(s=o[1],/(ΑΡΚ|ΚΑΛΙΑΚ|ΠΕΤΑΛ|ΛΙΧ|ΠΛΕΞ|ΣΚ|Σ|ΦΛ|ΦΡ|ΒΕΛ|ΛΟΥΛ|ΧΝ|ΣΠ|ΤΡΑΓ|ΦΕ)$/.test(o[1])&&(s+="ΟΥΔ")),null!==(o=/^(.+?)(ΕΩΣ|ΕΩΝ|ΕΑΣ|ΕΑ)$/.exec(s))&&(s=o[1],/^(Θ|Δ|ΕΛ|ΓΑΛ|Ν|Π|ΙΔ|ΠΑΡ|ΣΤΕΡ|ΟΡΦ|ΑΝΔΡ|ΑΝΤΡ)$/.test(o[1])&&(s+="Ε")),null!==(o=/^(.+?)(ΕΙΟ|ΕΙΟΣ|ΕΙΟΙ|ΕΙΑ|ΕΙΑΣ|ΕΙΕΣ|ΕΙΟΥ|ΕΙΟΥΣ|ΕΙΩΝ)$/.exec(s))&&o[1].length>4&&(s=o[1]),null!==(o=/^(.+?)(ΙΟΥΣ|ΙΑΣ|ΙΕΣ|ΙΟΣ|ΙΟΥ|ΙΟΙ|ΙΩΝ|ΙΟΝ|ΙΑ|ΙΟ)$/.exec(s))&&(s=o[1],(t(s)||s.length<2||/^(ΑΓ|ΑΓΓΕΛ|ΑΓΡ|ΑΕΡ|ΑΘΛ|ΑΚΟΥΣ|ΑΞ|ΑΣ|Β|ΒΙΒΛ|ΒΥΤ|Γ|ΓΙΑΓ|ΓΩΝ|Δ|ΔΑΝ|ΔΗΛ|ΔΗΜ|ΔΟΚΙΜ|ΕΛ|ΖΑΧΑΡ|ΗΛ|ΗΠ|ΙΔ|ΙΣΚ|ΙΣΤ|ΙΟΝ|ΙΩΝ|ΚΙΜΩΛ|ΚΟΛΟΝ|ΚΟΡ|ΚΤΗΡ|ΚΥΡ|ΛΑΓ|ΛΟΓ|ΜΑΓ|ΜΠΑΝ|ΜΠΡ|ΝΑΥΤ|ΝΟΤ|ΟΠΑΛ|ΟΞ|ΟΡ|ΟΣ|ΠΑΝΑΓ|ΠΑΤΡ|ΠΗΛ|ΠΗΝ|ΠΛΑΙΣ|ΠΟΝΤ|ΡΑΔ|ΡΟΔ|ΣΚ|ΣΚΟΡΠ|ΣΟΥΝ|ΣΠΑΝ|ΣΤΑΔ|ΣΥΡ|ΤΗΛ|ΤΙΜ|ΤΟΚ|ΤΟΠ|ΤΡΟΧ|ΦΙΛ|ΦΩΤ|Χ|ΧΙΛ|ΧΡΩΜ|ΧΩΡ)$/.test(o[1]))&&(s+="Ι"),/^(ΠΑΛ)$/.test(o[1])&&(s+="ΑΙ")),null!==(o=/^(.+?)(ΙΚΟΣ|ΙΚΟΝ|ΙΚΕΙΣ|ΙΚΟΙ|ΙΚΕΣ|ΙΚΟΥΣ|ΙΚΗ|ΙΚΗΣ|ΙΚΟ|ΙΚΑ|ΙΚΟΥ|ΙΚΩΝ|ΙΚΩΣ)$/.exec(s))&&(s=o[1],(t(s)||/^(ΑΔ|ΑΛ|ΑΜΑΝ|ΑΜΕΡ|ΑΜΜΟΧΑΛ|ΑΝΗΘ|ΑΝΤΙΔ|ΑΠΛ|ΑΤΤ|ΑΦΡ|ΒΑΣ|ΒΡΩΜ|ΓΕΝ|ΓΕΡ|Δ|ΔΙΚΑΝ|ΔΥΤ|ΕΙΔ|ΕΝΔ|ΕΞΩΔ|ΗΘ|ΘΕΤ|ΚΑΛΛΙΝ|ΚΑΛΠ|ΚΑΤΑΔ|ΚΟΥΖΙΝ|ΚΡ|ΚΩΔ|ΛΟΓ|Μ|ΜΕΡ|ΜΟΝΑΔ|ΜΟΥΛ|ΜΟΥΣ|ΜΠΑΓΙΑΤ|ΜΠΑΝ|ΜΠΟΛ|ΜΠΟΣ|ΜΥΣΤ|Ν|ΝΙΤ|ΞΙΚ|ΟΠΤ|ΠΑΝ|ΠΕΤΣ|ΠΙΚΑΝΤ|ΠΙΤΣ|ΠΛΑΣΤ|ΠΛΙΑΤΣ|ΠΟΝΤ|ΠΟΣΤΕΛΝ|ΠΡΩΤΟΔ|ΣΕΡΤ|ΣΗΜΑΝΤ|ΣΤΑΤ|ΣΥΝΑΔ|ΣΥΝΟΜΗΛ|ΤΕΛ|ΤΕΧΝ|ΤΡΟΠ|ΤΣΑΜ|ΥΠΟΔ|Φ|ΦΙΛΟΝ|ΦΥΛΟΔ|ΦΥΣ|ΧΑΣ)$/.test(o[1])||/(ΦΟΙΝ)$/.test(o[1]))&&(s+="ΙΚ")),"ΑΓΑΜΕ"===s&&(s="ΑΓΑΜ"),null!==(o=/^(.+?)(ΑΓΑΜΕ|ΗΣΑΜΕ|ΟΥΣΑΜΕ|ΗΚΑΜΕ|ΗΘΗΚΑΜΕ)$/.exec(s))&&(s=o[1]),null!==(o=/^(.+?)(ΑΜΕ)$/.exec(s))&&(s=o[1],/^(ΑΝΑΠ|ΑΠΟΘ|ΑΠΟΚ|ΑΠΟΣΤ|ΒΟΥΒ|ΞΕΘ|ΟΥΛ|ΠΕΘ|ΠΙΚΡ|ΠΟΤ|ΣΙΧ|Χ)$/.test(o[1])&&(s+="ΑΜ")),null!==(o=/^(.+?)(ΑΓΑΝΕ|ΗΣΑΝΕ|ΟΥΣΑΝΕ|ΙΟΝΤΑΝΕ|ΙΟΤΑΝΕ|ΙΟΥΝΤΑΝΕ|ΟΝΤΑΝΕ|ΟΤΑΝΕ|ΟΥΝΤΑΝΕ|ΗΚΑΝΕ|ΗΘΗΚΑΝΕ)$/.exec(s))&&(s=o[1],/^(ΤΡ|ΤΣ)$/.test(o[1])&&(s+="ΑΓΑΝ")),null!==(o=/^(.+?)(ΑΝΕ)$/.exec(s))&&(s=o[1],(r(s)||/^(ΒΕΤΕΡ|ΒΟΥΛΚ|ΒΡΑΧΜ|Γ|ΔΡΑΔΟΥΜ|Θ|ΚΑΛΠΟΥΖ|ΚΑΣΤΕΛ|ΚΟΡΜΟΡ|ΛΑΟΠΛ|ΜΩΑΜΕΘ|Μ|ΜΟΥΣΟΥΛΜΑΝ|ΟΥΛ|Π|ΠΕΛΕΚ|ΠΛ|ΠΟΛΙΣ|ΠΟΡΤΟΛ|ΣΑΡΑΚΑΤΣ|ΣΟΥΛΤ|ΤΣΑΡΛΑΤ|ΟΡΦ|ΤΣΙΓΓ|ΤΣΟΠ|ΦΩΤΟΣΤΕΦ|Χ|ΨΥΧΟΠΛ|ΑΓ|ΟΡΦ|ΓΑΛ|ΓΕΡ|ΔΕΚ|ΔΙΠΛ|ΑΜΕΡΙΚΑΝ|ΟΥΡ|ΠΙΘ|ΠΟΥΡΙΤ|Σ|ΖΩΝΤ|ΙΚ|ΚΑΣΤ|ΚΟΠ|ΛΙΧ|ΛΟΥΘΗΡ|ΜΑΙΝΤ|ΜΕΛ|ΣΙΓ|ΣΠ|ΣΤΕΓ|ΤΡΑΓ|ΤΣΑΓ|Φ|ΕΡ|ΑΔΑΠ|ΑΘΙΓΓ|ΑΜΗΧ|ΑΝΙΚ|ΑΝΟΡΓ|ΑΠΗΓ|ΑΠΙΘ|ΑΤΣΙΓΓ|ΒΑΣ|ΒΑΣΚ|ΒΑΘΥΓΑΛ|ΒΙΟΜΗΧ|ΒΡΑΧΥΚ|ΔΙΑΤ|ΔΙΑΦ|ΕΝΟΡΓ|ΘΥΣ|ΚΑΠΝΟΒΙΟΜΗΧ|ΚΑΤΑΓΑΛ|ΚΛΙΒ|ΚΟΙΛΑΡΦ|ΛΙΒ|ΜΕΓΛΟΒΙΟΜΗΧ|ΜΙΚΡΟΒΙΟΜΗΧ|ΝΤΑΒ|ΞΗΡΟΚΛΙΒ|ΟΛΙΓΟΔΑΜ|ΟΛΟΓΑΛ|ΠΕΝΤΑΡΦ|ΠΕΡΗΦ|ΠΕΡΙΤΡ|ΠΛΑΤ|ΠΟΛΥΔΑΠ|ΠΟΛΥΜΗΧ|ΣΤΕΦ|ΤΑΒ|ΤΕΤ|ΥΠΕΡΗΦ|ΥΠΟΚΟΠ|ΧΑΜΗΛΟΔΑΠ|ΨΗΛΟΤΑΒ)$/.test(o[1]))&&(s+="ΑΝ")),null!==(o=/^(.+?)(ΗΣΕΤΕ)$/.exec(s))&&(s=o[1]),null!==(o=/^(.+?)(ΕΤΕ)$/.exec(s))&&(s=o[1],(r(s)||/(ΟΔ|ΑΙΡ|ΦΟΡ|ΤΑΘ|ΔΙΑΘ|ΣΧ|ΕΝΔ|ΕΥΡ|ΤΙΘ|ΥΠΕΡΘ|ΡΑΘ|ΕΝΘ|ΡΟΘ|ΣΘ|ΠΥΡ|ΑΙΝ|ΣΥΝΔ|ΣΥΝ|ΣΥΝΘ|ΧΩΡ|ΠΟΝ|ΒΡ|ΚΑΘ|ΕΥΘ|ΕΚΘ|ΝΕΤ|ΡΟΝ|ΑΡΚ|ΒΑΡ|ΒΟΛ|ΩΦΕΛ)$/.test(o[1])||/^(ΑΒΑΡ|ΒΕΝ|ΕΝΑΡ|ΑΒΡ|ΑΔ|ΑΘ|ΑΝ|ΑΠΛ|ΒΑΡΟΝ|ΝΤΡ|ΣΚ|ΚΟΠ|ΜΠΟΡ|ΝΙΦ|ΠΑΓ|ΠΑΡΑΚΑΛ|ΣΕΡΠ|ΣΚΕΛ|ΣΥΡΦ|ΤΟΚ|Υ|Δ|ΕΜ|ΘΑΡΡ|Θ)$/.test(o[1]))&&(s+="ΕΤ")),null!==(o=/^(.+?)(ΟΝΤΑΣ|ΩΝΤΑΣ)$/.exec(s))&&(s=o[1],/^ΑΡΧ$/.test(o[1])&&(s+="ΟΝΤ"),/ΚΡΕ$/.test(o[1])&&(s+="ΩΝΤ")),null!==(o=/^(.+?)(ΟΜΑΣΤΕ|ΙΟΜΑΣΤΕ)$/.exec(s))&&(s=o[1],/^ΟΝ$/.test(o[1])&&(s+="ΟΜΑΣΤ")),null!==(o=/^(.+?)(ΙΕΣΤΕ)$/.exec(s))&&(s=o[1],/^(Π|ΑΠ|ΣΥΜΠ|ΑΣΥΜΠ|ΑΚΑΤΑΠ|ΑΜΕΤΑΜΦ)$/.test(o[1])&&(s+="ΙΕΣΤ")),null!==(o=/^(.+?)(ΕΣΤΕ)$/.exec(s))&&(s=o[1],/^(ΑΛ|ΑΡ|ΕΚΤΕΛ|Ζ|Μ|Ξ|ΠΑΡΑΚΑΛ|ΠΡΟ|ΝΙΣ)$/.test(o[1])&&(s+="ΕΣΤ")),null!==(o=/^(.+?)(ΗΘΗΚΑ|ΗΘΗΚΕΣ|ΗΘΗΚΕ)$/.exec(s))&&(s=o[1]),null!==(o=/^(.+?)(ΗΚΑ|ΗΚΕΣ|ΗΚΕ)$/.exec(s))&&(s=o[1],(/(ΣΚΩΛ|ΣΚΟΥΛ|ΝΑΡΘ|ΣΦ|ΟΘ|ΠΙΘ)$/.test(o[1])||/^(ΔΙΑΘ|Θ|ΠΑΡΑΚΑΤΑΘ|ΠΡΟΣΘ|ΣΥΝΘ)$/.test(o[1]))&&(s+="ΗΚ")),null!==(o=/^(.+?)(ΟΥΣΑ|ΟΥΣΕΣ|ΟΥΣΕ)$/.exec(s))&&(s=o[1],(t(s)||/^(ΦΑΡΜΑΚ|ΧΑΔ|ΑΓΚ|ΑΝΑΡΡ|ΒΡΟΜ|ΕΚΛΙΠ|ΛΑΜΠΙΔ|ΛΕΧ|Μ|ΠΑΤ|Ρ|Λ|ΜΕΔ|ΜΕΣΑΖ|ΥΠΟΤΕΙΝ|ΑΜ|ΑΙΘ|ΑΝΗΚ|ΔΕΣΠΟΖ|ΕΝΔΙΑΦΕΡ)$/.test(o[1])||/(ΠΟΔΑΡ|ΒΛΕΠ|ΠΑΝΤΑΧ|ΦΡΥΔ|ΜΑΝΤΙΛ|ΜΑΛΛ|ΚΥΜΑΤ|ΛΑΧ|ΛΗΓ|ΦΑΓ|ΟΜ|ΠΡΩΤ)$/.test(o[1]))&&(s+="ΟΥΣ")),null!==(o=/^(.+?)(ΑΓΑ|ΑΓΕΣ|ΑΓΕ)$/.exec(s))&&(s=o[1],(/^(ΑΒΑΣΤ|ΠΟΛΥΦ|ΑΔΗΦ|ΠΑΜΦ|Ρ|ΑΣΠ|ΑΦ|ΑΜΑΛ|ΑΜΑΛΛΙ|ΑΝΥΣΤ|ΑΠΕΡ|ΑΣΠΑΡ|ΑΧΑΡ|ΔΕΡΒΕΝ|ΔΡΟΣΟΠ|ΞΕΦ|ΝΕΟΠ|ΝΟΜΟΤ|ΟΛΟΠ|ΟΜΟΤ|ΠΡΟΣΤ|ΠΡΟΣΩΠΟΠ|ΣΥΜΠ|ΣΥΝΤ|Τ|ΥΠΟΤ|ΧΑΡ|ΑΕΙΠ|ΑΙΜΟΣΤ|ΑΝΥΠ|ΑΠΟΤ|ΑΡΤΙΠ|ΔΙΑΤ|ΕΝ|ΕΠΙΤ|ΚΡΟΚΑΛΟΠ|ΣΙΔΗΡΟΠ|Λ|ΝΑΥ|ΟΥΛΑΜ|ΟΥΡ|Π|ΤΡ|Μ)$/.test(o[1])||/(ΟΦ|ΠΕΛ|ΧΟΡΤ|ΛΛ|ΣΦ|ΡΠ|ΦΡ|ΠΡ|ΛΟΧ|ΣΜΗΝ)$/.test(o[1])&&!/^(ΨΟΦ|ΝΑΥΛΟΧ)$/.test(o[1])||/(ΚΟΛΛ)$/.test(o[1]))&&(s+="ΑΓ")),null!==(o=/^(.+?)(ΗΣΕ|ΗΣΟΥ|ΗΣΑ)$/.exec(s))&&(s=o[1],/^(Ν|ΧΕΡΣΟΝ|ΔΩΔΕΚΑΝ|ΕΡΗΜΟΝ|ΜΕΓΑΛΟΝ|ΕΠΤΑΝ|Ι)$/.test(o[1])&&(s+="ΗΣ")),null!==(o=/^(.+?)(ΗΣΤΕ)$/.exec(s))&&(s=o[1],/^(ΑΣΒ|ΣΒ|ΑΧΡ|ΧΡ|ΑΠΛ|ΑΕΙΜΝ|ΔΥΣΧΡ|ΕΥΧΡ|ΚΟΙΝΟΧΡ|ΠΑΛΙΜΨ)$/.test(o[1])&&(s+="ΗΣΤ")),null!==(o=/^(.+?)(ΟΥΝΕ|ΗΣΟΥΝΕ|ΗΘΟΥΝΕ)$/.exec(s))&&(s=o[1],/^(Ν|Ρ|ΣΠΙ|ΣΤΡΑΒΟΜΟΥΤΣ|ΚΑΚΟΜΟΥΤΣ|ΕΞΩΝ)$/.test(o[1])&&(s+="ΟΥΝ")),null!==(o=/^(.+?)(ΟΥΜΕ|ΗΣΟΥΜΕ|ΗΘΟΥΜΕ)$/.exec(s))&&(s=o[1],/^(ΠΑΡΑΣΟΥΣ|Φ|Χ|ΩΡΙΟΠΛ|ΑΖ|ΑΛΛΟΣΟΥΣ|ΑΣΟΥΣ)$/.test(o[1])&&(s+="ΟΥΜ")),null!=(o=/^(.+?)(ΜΑΤΟΙ|ΜΑΤΟΥΣ|ΜΑΤΟ|ΜΑΤΑ|ΜΑΤΩΣ|ΜΑΤΩΝ|ΜΑΤΟΣ|ΜΑΤΕΣ|ΜΑΤΗ|ΜΑΤΗΣ|ΜΑΤΟΥ)$/.exec(s))&&(s=o[1]+"Μ",/^(ΓΡΑΜ)$/.test(o[1])?s+="Α":/^(ΓΕ|ΣΤΑ)$/.test(o[1])&&(s+="ΑΤ")),null!==(o=/^(.+?)(ΟΥΑ)$/.exec(s))&&(s=o[1]+"ΟΥ"),n.length===s.length&&null!==(o=/^(.+?)(Α|ΑΓΑΤΕ|ΑΓΑΝ|ΑΕΙ|ΑΜΑΙ|ΑΝ|ΑΣ|ΑΣΑΙ|ΑΤΑΙ|ΑΩ|Ε|ΕΙ|ΕΙΣ|ΕΙΤΕ|ΕΣΑΙ|ΕΣ|ΕΤΑΙ|Ι|ΙΕΜΑΙ|ΙΕΜΑΣΤΕ|ΙΕΤΑΙ|ΙΕΣΑΙ|ΙΕΣΑΣΤΕ|ΙΟΜΑΣΤΑΝ|ΙΟΜΟΥΝ|ΙΟΜΟΥΝΑ|ΙΟΝΤΑΝ|ΙΟΝΤΟΥΣΑΝ|ΙΟΣΑΣΤΑΝ|ΙΟΣΑΣΤΕ|ΙΟΣΟΥΝ|ΙΟΣΟΥΝΑ|ΙΟΤΑΝ|ΙΟΥΜΑ|ΙΟΥΜΑΣΤΕ|ΙΟΥΝΤΑΙ|ΙΟΥΝΤΑΝ|Η|ΗΔΕΣ|ΗΔΩΝ|ΗΘΕΙ|ΗΘΕΙΣ|ΗΘΕΙΤΕ|ΗΘΗΚΑΤΕ|ΗΘΗΚΑΝ|ΗΘΟΥΝ|ΗΘΩ|ΗΚΑΤΕ|ΗΚΑΝ|ΗΣ|ΗΣΑΝ|ΗΣΑΤΕ|ΗΣΕΙ|ΗΣΕΣ|ΗΣΟΥΝ|ΗΣΩ|Ο|ΟΙ|ΟΜΑΙ|ΟΜΑΣΤΑΝ|ΟΜΟΥΝ|ΟΜΟΥΝΑ|ΟΝΤΑΙ|ΟΝΤΑΝ|ΟΝΤΟΥΣΑΝ|ΟΣ|ΟΣΑΣΤΑΝ|ΟΣΑΣΤΕ|ΟΣΟΥΝ|ΟΣΟΥΝΑ|ΟΤΑΝ|ΟΥ|ΟΥΜΑΙ|ΟΥΜΑΣΤΕ|ΟΥΝ|ΟΥΝΤΑΙ|ΟΥΝΤΑΝ|ΟΥΣ|ΟΥΣΑΝ|ΟΥΣΑΤΕ|Υ||ΥΑ|ΥΣ|Ω|ΩΝ|ΟΙΣ)$/.exec(s))&&(s=o[1]),null!=(o=/^(.+?)(ΕΣΤΕΡ|ΕΣΤΑΤ|ΟΤΕΡ|ΟΤΑΤ|ΥΤΕΡ|ΥΤΑΤ|ΩΤΕΡ|ΩΤΑΤ)$/.exec(s))&&(/^(ΕΞ|ΕΣ|ΑΝ|ΚΑΤ|Κ|ΠΡ)$/.test(o[1])||(s=o[1]),/^(ΚΑ|Μ|ΕΛΕ|ΛΕ|ΔΕ)$/.test(o[1])&&(s+="ΥΤ")),s}var l={"ΦΑΓΙΑ":"ΦΑ","ΦΑΓΙΟΥ":"ΦΑ","ΦΑΓΙΩΝ":"ΦΑ","ΣΚΑΓΙΑ":"ΣΚΑ","ΣΚΑΓΙΟΥ":"ΣΚΑ","ΣΚΑΓΙΩΝ":"ΣΚΑ","ΣΟΓΙΟΥ":"ΣΟ","ΣΟΓΙΑ":"ΣΟ","ΣΟΓΙΩΝ":"ΣΟ","ΤΑΤΟΓΙΑ":"ΤΑΤΟ","ΤΑΤΟΓΙΟΥ":"ΤΑΤΟ","ΤΑΤΟΓΙΩΝ":"ΤΑΤΟ","ΚΡΕΑΣ":"ΚΡΕ","ΚΡΕΑΤΟΣ":"ΚΡΕ","ΚΡΕΑΤΑ":"ΚΡΕ","ΚΡΕΑΤΩΝ":"ΚΡΕ","ΠΕΡΑΣ":"ΠΕΡ","ΠΕΡΑΤΟΣ":"ΠΕΡ","ΠΕΡΑΤΑ":"ΠΕΡ","ΠΕΡΑΤΩΝ":"ΠΕΡ","ΤΕΡΑΣ":"ΤΕΡ","ΤΕΡΑΤΟΣ":"ΤΕΡ","ΤΕΡΑΤΑ":"ΤΕΡ","ΤΕΡΑΤΩΝ":"ΤΕΡ","ΦΩΣ":"ΦΩ","ΦΩΤΟΣ":"ΦΩ","ΦΩΤΑ":"ΦΩ","ΦΩΤΩΝ":"ΦΩ","ΚΑΘΕΣΤΩΣ":"ΚΑΘΕΣΤ","ΚΑΘΕΣΤΩΤΟΣ":"ΚΑΘΕΣΤ","ΚΑΘΕΣΤΩΤΑ":"ΚΑΘΕΣΤ","ΚΑΘΕΣΤΩΤΩΝ":"ΚΑΘΕΣΤ","ΓΕΓΟΝΟΣ":"ΓΕΓΟΝ","ΓΕΓΟΝΟΤΟΣ":"ΓΕΓΟΝ","ΓΕΓΟΝΟΤΑ":"ΓΕΓΟΝ","ΓΕΓΟΝΟΤΩΝ":"ΓΕΓΟΝ","ΕΥΑ":"ΕΥ"},i=["ΑΚΡΙΒΩΣ","ΑΛΑ","ΑΛΛΑ","ΑΛΛΙΩΣ","ΑΛΛΟΤΕ","ΑΜΑ","ΑΝΩ","ΑΝΑ","ΑΝΑΜΕΣΑ","ΑΝΑΜΕΤΑΞΥ","ΑΝΕΥ","ΑΝΤΙ","ΑΝΤΙΠΕΡΑ","ΑΝΤΙΟ","ΑΞΑΦΝΑ","ΑΠΟ","ΑΠΟΨΕ","ΑΡΑ","ΑΡΑΓΕ","ΑΥΡΙΟ","ΑΦΟΙ","ΑΦΟΥ","ΑΦΟΤΟΥ","ΒΡΕ","ΓΕΙΑ","ΓΙΑ","ΓΙΑΤΙ","ΓΡΑΜΜΑ","ΔΕΗ","ΔΕΝ","ΔΗΛΑΔΗ","ΔΙΧΩΣ","ΔΥΟ","ΕΑΝ","ΕΓΩ","ΕΔΩ","ΕΔΑ","ΕΙΘΕ","ΕΙΜΑΙ","ΕΙΜΑΣΤΕ","ΕΙΣΑΙ","ΕΙΣΑΣΤΕ","ΕΙΝΑΙ","ΕΙΣΤΕ","ΕΙΤΕ","ΕΚΕΙ","ΕΚΟ","ΕΛΑ","ΕΜΑΣ","ΕΜΕΙΣ","ΕΝΤΕΛΩΣ","ΕΝΤΟΣ","ΕΝΤΩΜΕΤΑΞΥ","ΕΝΩ","ΕΞΙ","ΕΞΙΣΟΥ","ΕΞΗΣ","ΕΞΩ","ΕΟΚ","ΕΠΑΝΩ","ΕΠΕΙΔΗ","ΕΠΕΙΤΑ","ΕΠΙ","ΕΠΙΣΗΣ","ΕΠΟΜΕΝΩΣ","ΕΠΤΑ","ΕΣΑΣ","ΕΣΕΙΣ","ΕΣΤΩ","ΕΣΥ","ΕΣΩ","ΕΤΣΙ","ΕΥΓΕ","ΕΦΕ","ΕΦΕΞΗΣ","ΕΧΤΕΣ","ΕΩΣ","ΗΔΗ","ΗΜΙ","ΗΠΑ","ΗΤΟΙ","ΘΕΣ","ΙΔΙΩΣ","ΙΔΗ","ΙΚΑ","ΙΣΩΣ","ΚΑΘΕ","ΚΑΘΕΤΙ","ΚΑΘΟΛΟΥ","ΚΑΘΩΣ","ΚΑΙ","ΚΑΝ","ΚΑΠΟΤΕ","ΚΑΠΟΥ","ΚΑΤΑ","ΚΑΤΙ","ΚΑΤΟΠΙΝ","ΚΑΤΩ","ΚΕΙ","ΚΙΧ","ΚΚΕ","ΚΟΛΑΝ","ΚΥΡΙΩΣ","ΚΩΣ","ΜΑΚΑΡΙ","ΜΑΛΙΣΤΑ","ΜΑΛΛΟΝ","ΜΑΙ","ΜΑΟ","ΜΑΟΥΣ","ΜΑΣ","ΜΕΘΑΥΡΙΟ","ΜΕΣ","ΜΕΣΑ","ΜΕΤΑ","ΜΕΤΑΞΥ","ΜΕΧΡΙ","ΜΗΔΕ","ΜΗΝ","ΜΗΠΩΣ","ΜΗΤΕ","ΜΙΑ","ΜΙΑΣ","ΜΙΣ","ΜΜΕ","ΜΟΛΟΝΟΤΙ","ΜΟΥ","ΜΠΑ","ΜΠΑΣ","ΜΠΟΥΦΑΝ","ΜΠΡΟΣ","ΝΑΙ","ΝΕΣ","ΝΤΑ","ΝΤΕ","ΞΑΝΑ","ΟΗΕ","ΟΚΤΩ","ΟΜΩΣ","ΟΝΕ","ΟΠΑ","ΟΠΟΥ","ΟΠΩΣ","ΟΣΟ","ΟΤΑΝ","ΟΤΕ","ΟΤΙ","ΟΥΤΕ","ΟΧΙ","ΠΑΛΙ","ΠΑΝ","ΠΑΝΟ","ΠΑΝΤΟΤΕ","ΠΑΝΤΟΥ","ΠΑΝΤΩΣ","ΠΑΝΩ","ΠΑΡΑ","ΠΕΡΑ","ΠΕΡΙ","ΠΕΡΙΠΟΥ","ΠΙΑ","ΠΙΟ","ΠΙΣΩ","ΠΛΑΙ","ΠΛΕΟΝ","ΠΛΗΝ","ΠΟΤΕ","ΠΟΥ","ΠΡΟ","ΠΡΟΣ","ΠΡΟΧΤΕΣ","ΠΡΟΧΘΕΣ","ΡΟΔΙ","ΠΩΣ","ΣΑΙ","ΣΑΣ","ΣΑΝ","ΣΕΙΣ","ΣΙΑ","ΣΚΙ","ΣΟΙ","ΣΟΥ","ΣΡΙ","ΣΥΝ","ΣΥΝΑΜΑ","ΣΧΕΔΟΝ","ΤΑΔΕ","ΤΑΞΙ","ΤΑΧΑ","ΤΕΙ","ΤΗΝ","ΤΗΣ","ΤΙΠΟΤΑ","ΤΙΠΟΤΕ","ΤΙΣ","ΤΟΝ","ΤΟΤΕ","ΤΟΥ","ΤΟΥΣ","ΤΣΑ","ΤΣΕ","ΤΣΙ","ΤΣΟΥ","ΤΩΝ","ΥΠΟ","ΥΠΟΨΗ","ΥΠΟΨΙΝ","ΥΣΤΕΡΑ","ΦΕΤΟΣ","ΦΙΣ","ΦΠΑ","ΧΑΦ","ΧΘΕΣ","ΧΤΕΣ","ΧΩΡΙΣ","ΩΣ","ΩΣΑΝ","ΩΣΟΤΟΥ","ΩΣΠΟΥ","ΩΣΤΕ","ΩΣΤΟΣΟ"],s=new RegExp("^[ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩ]+$");return function(e){return"function"==typeof e.update?e.update(function(e){return n(e.toUpperCase()).toLowerCase()}):n(e.toUpperCase()).toLowerCase()}}(),e.Pipeline.registerFunction(e.el.stemmer,"stemmer-el"),e.el.stopWordFilter=e.generateStopWordFilter("αλλα αν αντι απο αυτα αυτεσ αυτη αυτο αυτοι αυτοσ αυτουσ αυτων για δε δεν εαν ειμαι ειμαστε ειναι εισαι ειστε εκεινα εκεινεσ εκεινη εκεινο εκεινοι εκεινοσ εκεινουσ εκεινων ενω επι η θα ισωσ κ και κατα κι μα με μετα μη μην να ο οι ομωσ οπωσ οσο οτι παρα ποια ποιεσ ποιο ποιοι ποιοσ ποιουσ ποιων που προσ πωσ σε στη στην στο στον τα την τησ το τον τοτε του των ωσ".split(" ")),e.Pipeline.registerFunction(e.el.stopWordFilter,"stopWordFilter-el"),e.el.normilizer=function(){var e={"Ά":"Α","ά":"α","Έ":"Ε","έ":"ε","Ή":"Η","ή":"η","Ί":"Ι","ί":"ι","Ό":"Ο","ο":"ο","Ύ":"Υ","ύ":"υ","Ώ":"Ω","ώ":"ω","Ϊ":"Ι","ϊ":"ι","Ϋ":"Υ","ϋ":"υ","ΐ":"ι","ΰ":"υ"};return function(t){if("function"==typeof t.update)return t.update(function(t){for(var r="",n=0;n=A.limit)return!0;A.cursor++}return!1}return!0}function n(){if(A.in_grouping(x,97,252)){var s=A.cursor;if(e()){if(A.cursor=s,!A.in_grouping(x,97,252))return!0;for(;!A.out_grouping(x,97,252);){if(A.cursor>=A.limit)return!0;A.cursor++}}return!1}return!0}function i(){var s,r=A.cursor;if(n()){if(A.cursor=r,!A.out_grouping(x,97,252))return;if(s=A.cursor,e()){if(A.cursor=s,!A.in_grouping(x,97,252)||A.cursor>=A.limit)return;A.cursor++}}g=A.cursor}function a(){for(;!A.in_grouping(x,97,252);){if(A.cursor>=A.limit)return!1;A.cursor++}for(;!A.out_grouping(x,97,252);){if(A.cursor>=A.limit)return!1;A.cursor++}return!0}function t(){var e=A.cursor;g=A.limit,p=g,v=g,i(),A.cursor=e,a()&&(p=A.cursor,a()&&(v=A.cursor))}function o(){for(var e;;){if(A.bra=A.cursor,e=A.find_among(k,6))switch(A.ket=A.cursor,e){case 1:A.slice_from("a");continue;case 2:A.slice_from("e");continue;case 3:A.slice_from("i");continue;case 4:A.slice_from("o");continue;case 5:A.slice_from("u");continue;case 6:if(A.cursor>=A.limit)break;A.cursor++;continue}break}}function u(){return g<=A.cursor}function w(){return p<=A.cursor}function c(){return v<=A.cursor}function m(){var e;if(A.ket=A.cursor,A.find_among_b(y,13)&&(A.bra=A.cursor,(e=A.find_among_b(q,11))&&u()))switch(e){case 1:A.bra=A.cursor,A.slice_from("iendo");break;case 2:A.bra=A.cursor,A.slice_from("ando");break;case 3:A.bra=A.cursor,A.slice_from("ar");break;case 4:A.bra=A.cursor,A.slice_from("er");break;case 5:A.bra=A.cursor,A.slice_from("ir");break;case 6:A.slice_del();break;case 7:A.eq_s_b(1,"u")&&A.slice_del()}}function l(e,s){if(!c())return!0;A.slice_del(),A.ket=A.cursor;var r=A.find_among_b(e,s);return r&&(A.bra=A.cursor,1==r&&c()&&A.slice_del()),!1}function d(e){return!c()||(A.slice_del(),A.ket=A.cursor,A.eq_s_b(2,e)&&(A.bra=A.cursor,c()&&A.slice_del()),!1)}function b(){var e;if(A.ket=A.cursor,e=A.find_among_b(S,46)){switch(A.bra=A.cursor,e){case 1:if(!c())return!1;A.slice_del();break;case 2:if(d("ic"))return!1;break;case 3:if(!c())return!1;A.slice_from("log");break;case 4:if(!c())return!1;A.slice_from("u");break;case 5:if(!c())return!1;A.slice_from("ente");break;case 6:if(!w())return!1;A.slice_del(),A.ket=A.cursor,e=A.find_among_b(C,4),e&&(A.bra=A.cursor,c()&&(A.slice_del(),1==e&&(A.ket=A.cursor,A.eq_s_b(2,"at")&&(A.bra=A.cursor,c()&&A.slice_del()))));break;case 7:if(l(P,3))return!1;break;case 8:if(l(F,3))return!1;break;case 9:if(d("at"))return!1}return!0}return!1}function f(){var e,s;if(A.cursor>=g&&(s=A.limit_backward,A.limit_backward=g,A.ket=A.cursor,e=A.find_among_b(W,12),A.limit_backward=s,e)){if(A.bra=A.cursor,1==e){if(!A.eq_s_b(1,"u"))return!1;A.slice_del()}return!0}return!1}function _(){var e,s,r,n;if(A.cursor>=g&&(s=A.limit_backward,A.limit_backward=g,A.ket=A.cursor,e=A.find_among_b(L,96),A.limit_backward=s,e))switch(A.bra=A.cursor,e){case 1:r=A.limit-A.cursor,A.eq_s_b(1,"u")?(n=A.limit-A.cursor,A.eq_s_b(1,"g")?A.cursor=A.limit-n:A.cursor=A.limit-r):A.cursor=A.limit-r,A.bra=A.cursor;case 2:A.slice_del()}}function h(){var e,s;if(A.ket=A.cursor,e=A.find_among_b(z,8))switch(A.bra=A.cursor,e){case 1:u()&&A.slice_del();break;case 2:u()&&(A.slice_del(),A.ket=A.cursor,A.eq_s_b(1,"u")&&(A.bra=A.cursor,s=A.limit-A.cursor,A.eq_s_b(1,"g")&&(A.cursor=A.limit-s,u()&&A.slice_del())))}}var v,p,g,k=[new s("",-1,6),new s("á",0,1),new s("é",0,2),new s("í",0,3),new s("ó",0,4),new s("ú",0,5)],y=[new s("la",-1,-1),new s("sela",0,-1),new s("le",-1,-1),new s("me",-1,-1),new s("se",-1,-1),new s("lo",-1,-1),new s("selo",5,-1),new s("las",-1,-1),new s("selas",7,-1),new s("les",-1,-1),new s("los",-1,-1),new s("selos",10,-1),new s("nos",-1,-1)],q=[new s("ando",-1,6),new s("iendo",-1,6),new s("yendo",-1,7),new s("ándo",-1,2),new s("iéndo",-1,1),new s("ar",-1,6),new s("er",-1,6),new s("ir",-1,6),new s("ár",-1,3),new s("ér",-1,4),new s("ír",-1,5)],C=[new s("ic",-1,-1),new s("ad",-1,-1),new s("os",-1,-1),new s("iv",-1,1)],P=[new s("able",-1,1),new s("ible",-1,1),new s("ante",-1,1)],F=[new s("ic",-1,1),new s("abil",-1,1),new s("iv",-1,1)],S=[new s("ica",-1,1),new s("ancia",-1,2),new s("encia",-1,5),new s("adora",-1,2),new s("osa",-1,1),new s("ista",-1,1),new s("iva",-1,9),new s("anza",-1,1),new s("logía",-1,3),new s("idad",-1,8),new s("able",-1,1),new s("ible",-1,1),new s("ante",-1,2),new s("mente",-1,7),new s("amente",13,6),new s("ación",-1,2),new s("ución",-1,4),new s("ico",-1,1),new s("ismo",-1,1),new s("oso",-1,1),new s("amiento",-1,1),new s("imiento",-1,1),new s("ivo",-1,9),new s("ador",-1,2),new s("icas",-1,1),new s("ancias",-1,2),new s("encias",-1,5),new s("adoras",-1,2),new s("osas",-1,1),new s("istas",-1,1),new s("ivas",-1,9),new s("anzas",-1,1),new s("logías",-1,3),new s("idades",-1,8),new s("ables",-1,1),new s("ibles",-1,1),new s("aciones",-1,2),new s("uciones",-1,4),new s("adores",-1,2),new s("antes",-1,2),new s("icos",-1,1),new s("ismos",-1,1),new s("osos",-1,1),new s("amientos",-1,1),new s("imientos",-1,1),new s("ivos",-1,9)],W=[new s("ya",-1,1),new s("ye",-1,1),new s("yan",-1,1),new s("yen",-1,1),new s("yeron",-1,1),new s("yendo",-1,1),new s("yo",-1,1),new s("yas",-1,1),new s("yes",-1,1),new s("yais",-1,1),new s("yamos",-1,1),new s("yó",-1,1)],L=[new s("aba",-1,2),new s("ada",-1,2),new s("ida",-1,2),new s("ara",-1,2),new s("iera",-1,2),new s("ía",-1,2),new s("aría",5,2),new s("ería",5,2),new s("iría",5,2),new s("ad",-1,2),new s("ed",-1,2),new s("id",-1,2),new s("ase",-1,2),new s("iese",-1,2),new s("aste",-1,2),new s("iste",-1,2),new s("an",-1,2),new s("aban",16,2),new s("aran",16,2),new s("ieran",16,2),new s("ían",16,2),new s("arían",20,2),new s("erían",20,2),new s("irían",20,2),new s("en",-1,1),new s("asen",24,2),new s("iesen",24,2),new s("aron",-1,2),new s("ieron",-1,2),new s("arán",-1,2),new s("erán",-1,2),new s("irán",-1,2),new s("ado",-1,2),new s("ido",-1,2),new s("ando",-1,2),new s("iendo",-1,2),new s("ar",-1,2),new s("er",-1,2),new s("ir",-1,2),new s("as",-1,2),new s("abas",39,2),new s("adas",39,2),new s("idas",39,2),new s("aras",39,2),new s("ieras",39,2),new s("ías",39,2),new s("arías",45,2),new s("erías",45,2),new s("irías",45,2),new s("es",-1,1),new s("ases",49,2),new s("ieses",49,2),new s("abais",-1,2),new s("arais",-1,2),new s("ierais",-1,2),new s("íais",-1,2),new s("aríais",55,2),new s("eríais",55,2),new s("iríais",55,2),new s("aseis",-1,2),new s("ieseis",-1,2),new s("asteis",-1,2),new s("isteis",-1,2),new s("áis",-1,2),new s("éis",-1,1),new s("aréis",64,2),new s("eréis",64,2),new s("iréis",64,2),new s("ados",-1,2),new s("idos",-1,2),new s("amos",-1,2),new s("ábamos",70,2),new s("áramos",70,2),new s("iéramos",70,2),new s("íamos",70,2),new s("aríamos",74,2),new s("eríamos",74,2),new s("iríamos",74,2),new s("emos",-1,1),new s("aremos",78,2),new s("eremos",78,2),new s("iremos",78,2),new s("ásemos",78,2),new s("iésemos",78,2),new s("imos",-1,2),new s("arás",-1,2),new s("erás",-1,2),new s("irás",-1,2),new s("ís",-1,2),new s("ará",-1,2),new s("erá",-1,2),new s("irá",-1,2),new s("aré",-1,2),new s("eré",-1,2),new s("iré",-1,2),new s("ió",-1,2)],z=[new s("a",-1,1),new s("e",-1,2),new s("o",-1,1),new s("os",-1,1),new s("á",-1,1),new s("é",-1,2),new s("í",-1,1),new s("ó",-1,1)],x=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,4,10],A=new r;this.setCurrent=function(e){A.setCurrent(e)},this.getCurrent=function(){return A.getCurrent()},this.stem=function(){var e=A.cursor;return t(),A.limit_backward=e,A.cursor=A.limit,m(),A.cursor=A.limit,b()||(A.cursor=A.limit,f()||(A.cursor=A.limit,_())),A.cursor=A.limit,h(),A.cursor=A.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.es.stemmer,"stemmer-es"),e.es.stopWordFilter=e.generateStopWordFilter("a al algo algunas algunos ante antes como con contra cual cuando de del desde donde durante e el ella ellas ellos en entre era erais eran eras eres es esa esas ese eso esos esta estaba estabais estaban estabas estad estada estadas estado estados estamos estando estar estaremos estará estarán estarás estaré estaréis estaría estaríais estaríamos estarían estarías estas este estemos esto estos estoy estuve estuviera estuvierais estuvieran estuvieras estuvieron estuviese estuvieseis estuviesen estuvieses estuvimos estuviste estuvisteis estuviéramos estuviésemos estuvo está estábamos estáis están estás esté estéis estén estés fue fuera fuerais fueran fueras fueron fuese fueseis fuesen fueses fui fuimos fuiste fuisteis fuéramos fuésemos ha habida habidas habido habidos habiendo habremos habrá habrán habrás habré habréis habría habríais habríamos habrían habrías habéis había habíais habíamos habían habías han has hasta hay haya hayamos hayan hayas hayáis he hemos hube hubiera hubierais hubieran hubieras hubieron hubiese hubieseis hubiesen hubieses hubimos hubiste hubisteis hubiéramos hubiésemos hubo la las le les lo los me mi mis mucho muchos muy más mí mía mías mío míos nada ni no nos nosotras nosotros nuestra nuestras nuestro nuestros o os otra otras otro otros para pero poco por porque que quien quienes qué se sea seamos sean seas seremos será serán serás seré seréis sería seríais seríamos serían serías seáis sido siendo sin sobre sois somos son soy su sus suya suyas suyo suyos sí también tanto te tendremos tendrá tendrán tendrás tendré tendréis tendría tendríais tendríamos tendrían tendrías tened tenemos tenga tengamos tengan tengas tengo tengáis tenida tenidas tenido tenidos teniendo tenéis tenía teníais teníamos tenían tenías ti tiene tienen tienes todo todos tu tus tuve tuviera tuvierais tuvieran tuvieras tuvieron tuviese tuvieseis tuviesen tuvieses tuvimos tuviste tuvisteis tuviéramos tuviésemos tuvo tuya tuyas tuyo tuyos tú un una uno unos vosotras vosotros vuestra vuestras vuestro vuestros y ya yo él éramos".split(" ")),e.Pipeline.registerFunction(e.es.stopWordFilter,"stopWordFilter-es")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.fi.min.js b/assets/javascripts/lunr/min/lunr.fi.min.js new file mode 100644 index 00000000..29f5dfce --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.fi.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Finnish` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(i,e){"function"==typeof define&&define.amd?define(e):"object"==typeof exports?module.exports=e():e()(i.lunr)}(this,function(){return function(i){if(void 0===i)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===i.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");i.fi=function(){this.pipeline.reset(),this.pipeline.add(i.fi.trimmer,i.fi.stopWordFilter,i.fi.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(i.fi.stemmer))},i.fi.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",i.fi.trimmer=i.trimmerSupport.generateTrimmer(i.fi.wordCharacters),i.Pipeline.registerFunction(i.fi.trimmer,"trimmer-fi"),i.fi.stemmer=function(){var e=i.stemmerSupport.Among,r=i.stemmerSupport.SnowballProgram,n=new function(){function i(){f=A.limit,d=f,n()||(f=A.cursor,n()||(d=A.cursor))}function n(){for(var i;;){if(i=A.cursor,A.in_grouping(W,97,246))break;if(A.cursor=i,i>=A.limit)return!0;A.cursor++}for(A.cursor=i;!A.out_grouping(W,97,246);){if(A.cursor>=A.limit)return!0;A.cursor++}return!1}function t(){return d<=A.cursor}function s(){var i,e;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(h,10)){switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:if(!A.in_grouping_b(x,97,246))return;break;case 2:if(!t())return}A.slice_del()}else A.limit_backward=e}function o(){var i,e,r;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(v,9))switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:r=A.limit-A.cursor,A.eq_s_b(1,"k")||(A.cursor=A.limit-r,A.slice_del());break;case 2:A.slice_del(),A.ket=A.cursor,A.eq_s_b(3,"kse")&&(A.bra=A.cursor,A.slice_from("ksi"));break;case 3:A.slice_del();break;case 4:A.find_among_b(p,6)&&A.slice_del();break;case 5:A.find_among_b(g,6)&&A.slice_del();break;case 6:A.find_among_b(j,2)&&A.slice_del()}else A.limit_backward=e}function l(){return A.find_among_b(q,7)}function a(){return A.eq_s_b(1,"i")&&A.in_grouping_b(L,97,246)}function u(){var i,e,r;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(C,30)){switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:if(!A.eq_s_b(1,"a"))return;break;case 2:case 9:if(!A.eq_s_b(1,"e"))return;break;case 3:if(!A.eq_s_b(1,"i"))return;break;case 4:if(!A.eq_s_b(1,"o"))return;break;case 5:if(!A.eq_s_b(1,"ä"))return;break;case 6:if(!A.eq_s_b(1,"ö"))return;break;case 7:if(r=A.limit-A.cursor,!l()&&(A.cursor=A.limit-r,!A.eq_s_b(2,"ie"))){A.cursor=A.limit-r;break}if(A.cursor=A.limit-r,A.cursor<=A.limit_backward){A.cursor=A.limit-r;break}A.cursor--,A.bra=A.cursor;break;case 8:if(!A.in_grouping_b(W,97,246)||!A.out_grouping_b(W,97,246))return}A.slice_del(),k=!0}else A.limit_backward=e}function c(){var i,e,r;if(A.cursor>=d)if(e=A.limit_backward,A.limit_backward=d,A.ket=A.cursor,i=A.find_among_b(P,14)){if(A.bra=A.cursor,A.limit_backward=e,1==i){if(r=A.limit-A.cursor,A.eq_s_b(2,"po"))return;A.cursor=A.limit-r}A.slice_del()}else A.limit_backward=e}function m(){var i;A.cursor>=f&&(i=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,A.find_among_b(F,2)?(A.bra=A.cursor,A.limit_backward=i,A.slice_del()):A.limit_backward=i)}function w(){var i,e,r,n,t,s;if(A.cursor>=f){if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,A.eq_s_b(1,"t")&&(A.bra=A.cursor,r=A.limit-A.cursor,A.in_grouping_b(W,97,246)&&(A.cursor=A.limit-r,A.slice_del(),A.limit_backward=e,n=A.limit-A.cursor,A.cursor>=d&&(A.cursor=d,t=A.limit_backward,A.limit_backward=A.cursor,A.cursor=A.limit-n,A.ket=A.cursor,i=A.find_among_b(S,2))))){if(A.bra=A.cursor,A.limit_backward=t,1==i){if(s=A.limit-A.cursor,A.eq_s_b(2,"po"))return;A.cursor=A.limit-s}return void A.slice_del()}A.limit_backward=e}}function _(){var i,e,r,n;if(A.cursor>=f){for(i=A.limit_backward,A.limit_backward=f,e=A.limit-A.cursor,l()&&(A.cursor=A.limit-e,A.ket=A.cursor,A.cursor>A.limit_backward&&(A.cursor--,A.bra=A.cursor,A.slice_del())),A.cursor=A.limit-e,A.ket=A.cursor,A.in_grouping_b(y,97,228)&&(A.bra=A.cursor,A.out_grouping_b(W,97,246)&&A.slice_del()),A.cursor=A.limit-e,A.ket=A.cursor,A.eq_s_b(1,"j")&&(A.bra=A.cursor,r=A.limit-A.cursor,A.eq_s_b(1,"o")?A.slice_del():(A.cursor=A.limit-r,A.eq_s_b(1,"u")&&A.slice_del())),A.cursor=A.limit-e,A.ket=A.cursor,A.eq_s_b(1,"o")&&(A.bra=A.cursor,A.eq_s_b(1,"j")&&A.slice_del()),A.cursor=A.limit-e,A.limit_backward=i;;){if(n=A.limit-A.cursor,A.out_grouping_b(W,97,246)){A.cursor=A.limit-n;break}if(A.cursor=A.limit-n,A.cursor<=A.limit_backward)return;A.cursor--}A.ket=A.cursor,A.cursor>A.limit_backward&&(A.cursor--,A.bra=A.cursor,b=A.slice_to(),A.eq_v_b(b)&&A.slice_del())}}var k,b,d,f,h=[new e("pa",-1,1),new e("sti",-1,2),new e("kaan",-1,1),new e("han",-1,1),new e("kin",-1,1),new e("hän",-1,1),new e("kään",-1,1),new e("ko",-1,1),new e("pä",-1,1),new e("kö",-1,1)],p=[new e("lla",-1,-1),new e("na",-1,-1),new e("ssa",-1,-1),new e("ta",-1,-1),new e("lta",3,-1),new e("sta",3,-1)],g=[new e("llä",-1,-1),new e("nä",-1,-1),new e("ssä",-1,-1),new e("tä",-1,-1),new e("ltä",3,-1),new e("stä",3,-1)],j=[new e("lle",-1,-1),new e("ine",-1,-1)],v=[new e("nsa",-1,3),new e("mme",-1,3),new e("nne",-1,3),new e("ni",-1,2),new e("si",-1,1),new e("an",-1,4),new e("en",-1,6),new e("än",-1,5),new e("nsä",-1,3)],q=[new e("aa",-1,-1),new e("ee",-1,-1),new e("ii",-1,-1),new e("oo",-1,-1),new e("uu",-1,-1),new e("ää",-1,-1),new e("öö",-1,-1)],C=[new e("a",-1,8),new e("lla",0,-1),new e("na",0,-1),new e("ssa",0,-1),new e("ta",0,-1),new e("lta",4,-1),new e("sta",4,-1),new e("tta",4,9),new e("lle",-1,-1),new e("ine",-1,-1),new e("ksi",-1,-1),new e("n",-1,7),new e("han",11,1),new e("den",11,-1,a),new e("seen",11,-1,l),new e("hen",11,2),new e("tten",11,-1,a),new e("hin",11,3),new e("siin",11,-1,a),new e("hon",11,4),new e("hän",11,5),new e("hön",11,6),new e("ä",-1,8),new e("llä",22,-1),new e("nä",22,-1),new e("ssä",22,-1),new e("tä",22,-1),new e("ltä",26,-1),new e("stä",26,-1),new e("ttä",26,9)],P=[new e("eja",-1,-1),new e("mma",-1,1),new e("imma",1,-1),new e("mpa",-1,1),new e("impa",3,-1),new e("mmi",-1,1),new e("immi",5,-1),new e("mpi",-1,1),new e("impi",7,-1),new e("ejä",-1,-1),new e("mmä",-1,1),new e("immä",10,-1),new e("mpä",-1,1),new e("impä",12,-1)],F=[new e("i",-1,-1),new e("j",-1,-1)],S=[new e("mma",-1,1),new e("imma",0,-1)],y=[17,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8],W=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],L=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],x=[17,97,24,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],A=new r;this.setCurrent=function(i){A.setCurrent(i)},this.getCurrent=function(){return A.getCurrent()},this.stem=function(){var e=A.cursor;return i(),k=!1,A.limit_backward=e,A.cursor=A.limit,s(),A.cursor=A.limit,o(),A.cursor=A.limit,u(),A.cursor=A.limit,c(),A.cursor=A.limit,k?(m(),A.cursor=A.limit):(A.cursor=A.limit,w(),A.cursor=A.limit),_(),!0}};return function(i){return"function"==typeof i.update?i.update(function(i){return n.setCurrent(i),n.stem(),n.getCurrent()}):(n.setCurrent(i),n.stem(),n.getCurrent())}}(),i.Pipeline.registerFunction(i.fi.stemmer,"stemmer-fi"),i.fi.stopWordFilter=i.generateStopWordFilter("ei eivät emme en et ette että he heidän heidät heihin heille heillä heiltä heissä heistä heitä hän häneen hänelle hänellä häneltä hänen hänessä hänestä hänet häntä itse ja johon joiden joihin joiksi joilla joille joilta joina joissa joista joita joka joksi jolla jolle jolta jona jonka jos jossa josta jota jotka kanssa keiden keihin keiksi keille keillä keiltä keinä keissä keistä keitä keneen keneksi kenelle kenellä keneltä kenen kenenä kenessä kenestä kenet ketkä ketkä ketä koska kuin kuka kun me meidän meidät meihin meille meillä meiltä meissä meistä meitä mihin miksi mikä mille millä miltä minkä minkä minua minulla minulle minulta minun minussa minusta minut minuun minä minä missä mistä mitkä mitä mukaan mutta ne niiden niihin niiksi niille niillä niiltä niin niin niinä niissä niistä niitä noiden noihin noiksi noilla noille noilta noin noina noissa noista noita nuo nyt näiden näihin näiksi näille näillä näiltä näinä näissä näistä näitä nämä ole olemme olen olet olette oli olimme olin olisi olisimme olisin olisit olisitte olisivat olit olitte olivat olla olleet ollut on ovat poikki se sekä sen siihen siinä siitä siksi sille sillä sillä siltä sinua sinulla sinulle sinulta sinun sinussa sinusta sinut sinuun sinä sinä sitä tai te teidän teidät teihin teille teillä teiltä teissä teistä teitä tuo tuohon tuoksi tuolla tuolle tuolta tuon tuona tuossa tuosta tuota tähän täksi tälle tällä tältä tämä tämän tänä tässä tästä tätä vaan vai vaikka yli".split(" ")),i.Pipeline.registerFunction(i.fi.stopWordFilter,"stopWordFilter-fi")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.fr.min.js b/assets/javascripts/lunr/min/lunr.fr.min.js new file mode 100644 index 00000000..68cd0094 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.fr.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `French` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.fr=function(){this.pipeline.reset(),this.pipeline.add(e.fr.trimmer,e.fr.stopWordFilter,e.fr.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.fr.stemmer))},e.fr.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.fr.trimmer=e.trimmerSupport.generateTrimmer(e.fr.wordCharacters),e.Pipeline.registerFunction(e.fr.trimmer,"trimmer-fr"),e.fr.stemmer=function(){var r=e.stemmerSupport.Among,s=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,s){return!(!W.eq_s(1,e)||(W.ket=W.cursor,!W.in_grouping(F,97,251)))&&(W.slice_from(r),W.cursor=s,!0)}function i(e,r,s){return!!W.eq_s(1,e)&&(W.ket=W.cursor,W.slice_from(r),W.cursor=s,!0)}function n(){for(var r,s;;){if(r=W.cursor,W.in_grouping(F,97,251)){if(W.bra=W.cursor,s=W.cursor,e("u","U",r))continue;if(W.cursor=s,e("i","I",r))continue;if(W.cursor=s,i("y","Y",r))continue}if(W.cursor=r,W.bra=r,!e("y","Y",r)){if(W.cursor=r,W.eq_s(1,"q")&&(W.bra=W.cursor,i("u","U",r)))continue;if(W.cursor=r,r>=W.limit)return;W.cursor++}}}function t(){for(;!W.in_grouping(F,97,251);){if(W.cursor>=W.limit)return!0;W.cursor++}for(;!W.out_grouping(F,97,251);){if(W.cursor>=W.limit)return!0;W.cursor++}return!1}function u(){var e=W.cursor;if(q=W.limit,g=q,p=q,W.in_grouping(F,97,251)&&W.in_grouping(F,97,251)&&W.cursor=W.limit){W.cursor=q;break}W.cursor++}while(!W.in_grouping(F,97,251))}q=W.cursor,W.cursor=e,t()||(g=W.cursor,t()||(p=W.cursor))}function o(){for(var e,r;;){if(r=W.cursor,W.bra=r,!(e=W.find_among(h,4)))break;switch(W.ket=W.cursor,e){case 1:W.slice_from("i");break;case 2:W.slice_from("u");break;case 3:W.slice_from("y");break;case 4:if(W.cursor>=W.limit)return;W.cursor++}}}function c(){return q<=W.cursor}function a(){return g<=W.cursor}function l(){return p<=W.cursor}function w(){var e,r;if(W.ket=W.cursor,e=W.find_among_b(C,43)){switch(W.bra=W.cursor,e){case 1:if(!l())return!1;W.slice_del();break;case 2:if(!l())return!1;W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"ic")&&(W.bra=W.cursor,l()?W.slice_del():W.slice_from("iqU"));break;case 3:if(!l())return!1;W.slice_from("log");break;case 4:if(!l())return!1;W.slice_from("u");break;case 5:if(!l())return!1;W.slice_from("ent");break;case 6:if(!c())return!1;if(W.slice_del(),W.ket=W.cursor,e=W.find_among_b(z,6))switch(W.bra=W.cursor,e){case 1:l()&&(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"at")&&(W.bra=W.cursor,l()&&W.slice_del()));break;case 2:l()?W.slice_del():a()&&W.slice_from("eux");break;case 3:l()&&W.slice_del();break;case 4:c()&&W.slice_from("i")}break;case 7:if(!l())return!1;if(W.slice_del(),W.ket=W.cursor,e=W.find_among_b(y,3))switch(W.bra=W.cursor,e){case 1:l()?W.slice_del():W.slice_from("abl");break;case 2:l()?W.slice_del():W.slice_from("iqU");break;case 3:l()&&W.slice_del()}break;case 8:if(!l())return!1;if(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"at")&&(W.bra=W.cursor,l()&&(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"ic")))){W.bra=W.cursor,l()?W.slice_del():W.slice_from("iqU");break}break;case 9:W.slice_from("eau");break;case 10:if(!a())return!1;W.slice_from("al");break;case 11:if(l())W.slice_del();else{if(!a())return!1;W.slice_from("eux")}break;case 12:if(!a()||!W.out_grouping_b(F,97,251))return!1;W.slice_del();break;case 13:return c()&&W.slice_from("ant"),!1;case 14:return c()&&W.slice_from("ent"),!1;case 15:return r=W.limit-W.cursor,W.in_grouping_b(F,97,251)&&c()&&(W.cursor=W.limit-r,W.slice_del()),!1}return!0}return!1}function f(){var e,r;if(W.cursor=q){if(s=W.limit_backward,W.limit_backward=q,W.ket=W.cursor,e=W.find_among_b(P,7))switch(W.bra=W.cursor,e){case 1:if(l()){if(i=W.limit-W.cursor,!W.eq_s_b(1,"s")&&(W.cursor=W.limit-i,!W.eq_s_b(1,"t")))break;W.slice_del()}break;case 2:W.slice_from("i");break;case 3:W.slice_del();break;case 4:W.eq_s_b(2,"gu")&&W.slice_del()}W.limit_backward=s}}function b(){var e=W.limit-W.cursor;W.find_among_b(U,5)&&(W.cursor=W.limit-e,W.ket=W.cursor,W.cursor>W.limit_backward&&(W.cursor--,W.bra=W.cursor,W.slice_del()))}function d(){for(var e,r=1;W.out_grouping_b(F,97,251);)r--;if(r<=0){if(W.ket=W.cursor,e=W.limit-W.cursor,!W.eq_s_b(1,"é")&&(W.cursor=W.limit-e,!W.eq_s_b(1,"è")))return;W.bra=W.cursor,W.slice_from("e")}}function k(){if(!w()&&(W.cursor=W.limit,!f()&&(W.cursor=W.limit,!m())))return W.cursor=W.limit,void _();W.cursor=W.limit,W.ket=W.cursor,W.eq_s_b(1,"Y")?(W.bra=W.cursor,W.slice_from("i")):(W.cursor=W.limit,W.eq_s_b(1,"ç")&&(W.bra=W.cursor,W.slice_from("c")))}var p,g,q,v=[new r("col",-1,-1),new r("par",-1,-1),new r("tap",-1,-1)],h=[new r("",-1,4),new r("I",0,1),new r("U",0,2),new r("Y",0,3)],z=[new r("iqU",-1,3),new r("abl",-1,3),new r("Ièr",-1,4),new r("ièr",-1,4),new r("eus",-1,2),new r("iv",-1,1)],y=[new r("ic",-1,2),new r("abil",-1,1),new r("iv",-1,3)],C=[new r("iqUe",-1,1),new r("atrice",-1,2),new r("ance",-1,1),new r("ence",-1,5),new r("logie",-1,3),new r("able",-1,1),new r("isme",-1,1),new r("euse",-1,11),new r("iste",-1,1),new r("ive",-1,8),new r("if",-1,8),new r("usion",-1,4),new r("ation",-1,2),new r("ution",-1,4),new r("ateur",-1,2),new r("iqUes",-1,1),new r("atrices",-1,2),new r("ances",-1,1),new r("ences",-1,5),new r("logies",-1,3),new r("ables",-1,1),new r("ismes",-1,1),new r("euses",-1,11),new r("istes",-1,1),new r("ives",-1,8),new r("ifs",-1,8),new r("usions",-1,4),new r("ations",-1,2),new r("utions",-1,4),new r("ateurs",-1,2),new r("ments",-1,15),new r("ements",30,6),new r("issements",31,12),new r("ités",-1,7),new r("ment",-1,15),new r("ement",34,6),new r("issement",35,12),new r("amment",34,13),new r("emment",34,14),new r("aux",-1,10),new r("eaux",39,9),new r("eux",-1,1),new r("ité",-1,7)],x=[new r("ira",-1,1),new r("ie",-1,1),new r("isse",-1,1),new r("issante",-1,1),new r("i",-1,1),new r("irai",4,1),new r("ir",-1,1),new r("iras",-1,1),new r("ies",-1,1),new r("îmes",-1,1),new r("isses",-1,1),new r("issantes",-1,1),new r("îtes",-1,1),new r("is",-1,1),new r("irais",13,1),new r("issais",13,1),new r("irions",-1,1),new r("issions",-1,1),new r("irons",-1,1),new r("issons",-1,1),new r("issants",-1,1),new r("it",-1,1),new r("irait",21,1),new r("issait",21,1),new r("issant",-1,1),new r("iraIent",-1,1),new r("issaIent",-1,1),new r("irent",-1,1),new r("issent",-1,1),new r("iront",-1,1),new r("ît",-1,1),new r("iriez",-1,1),new r("issiez",-1,1),new r("irez",-1,1),new r("issez",-1,1)],I=[new r("a",-1,3),new r("era",0,2),new r("asse",-1,3),new r("ante",-1,3),new r("ée",-1,2),new r("ai",-1,3),new r("erai",5,2),new r("er",-1,2),new r("as",-1,3),new r("eras",8,2),new r("âmes",-1,3),new r("asses",-1,3),new r("antes",-1,3),new r("âtes",-1,3),new r("ées",-1,2),new r("ais",-1,3),new r("erais",15,2),new r("ions",-1,1),new r("erions",17,2),new r("assions",17,3),new r("erons",-1,2),new r("ants",-1,3),new r("és",-1,2),new r("ait",-1,3),new r("erait",23,2),new r("ant",-1,3),new r("aIent",-1,3),new r("eraIent",26,2),new r("èrent",-1,2),new r("assent",-1,3),new r("eront",-1,2),new r("ât",-1,3),new r("ez",-1,2),new r("iez",32,2),new r("eriez",33,2),new r("assiez",33,3),new r("erez",32,2),new r("é",-1,2)],P=[new r("e",-1,3),new r("Ière",0,2),new r("ière",0,2),new r("ion",-1,1),new r("Ier",-1,2),new r("ier",-1,2),new r("ë",-1,4)],U=[new r("ell",-1,-1),new r("eill",-1,-1),new r("enn",-1,-1),new r("onn",-1,-1),new r("ett",-1,-1)],F=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,128,130,103,8,5],S=[1,65,20,0,0,0,0,0,0,0,0,0,0,0,0,0,128],W=new s;this.setCurrent=function(e){W.setCurrent(e)},this.getCurrent=function(){return W.getCurrent()},this.stem=function(){var e=W.cursor;return n(),W.cursor=e,u(),W.limit_backward=e,W.cursor=W.limit,k(),W.cursor=W.limit,b(),W.cursor=W.limit,d(),W.cursor=W.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.fr.stemmer,"stemmer-fr"),e.fr.stopWordFilter=e.generateStopWordFilter("ai aie aient aies ait as au aura aurai auraient aurais aurait auras aurez auriez aurions aurons auront aux avaient avais avait avec avez aviez avions avons ayant ayez ayons c ce ceci celà ces cet cette d dans de des du elle en es est et eu eue eues eurent eus eusse eussent eusses eussiez eussions eut eux eûmes eût eûtes furent fus fusse fussent fusses fussiez fussions fut fûmes fût fûtes ici il ils j je l la le les leur leurs lui m ma mais me mes moi mon même n ne nos notre nous on ont ou par pas pour qu que quel quelle quelles quels qui s sa sans se sera serai seraient serais serait seras serez seriez serions serons seront ses soi soient sois soit sommes son sont soyez soyons suis sur t ta te tes toi ton tu un une vos votre vous y à étaient étais était étant étiez étions été étée étées étés êtes".split(" ")),e.Pipeline.registerFunction(e.fr.stopWordFilter,"stopWordFilter-fr")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.he.min.js b/assets/javascripts/lunr/min/lunr.he.min.js new file mode 100644 index 00000000..b863d3ea --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.he.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.he=function(){this.pipeline.reset(),this.pipeline.add(e.he.trimmer,e.he.stopWordFilter,e.he.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.he.stemmer))},e.he.wordCharacters="֑-״א-תa-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.he.trimmer=e.trimmerSupport.generateTrimmer(e.he.wordCharacters),e.Pipeline.registerFunction(e.he.trimmer,"trimmer-he"),e.he.stemmer=function(){var e=this;return e.result=!1,e.preRemoved=!1,e.sufRemoved=!1,e.pre={pre1:"ה ו י ת",pre2:"ב כ ל מ ש כש",pre3:"הב הכ הל המ הש בש לכ",pre4:"וב וכ ול ומ וש",pre5:"מה שה כל",pre6:"מב מכ מל ממ מש",pre7:"בה בו בי בת כה כו כי כת לה לו לי לת",pre8:"ובה ובו ובי ובת וכה וכו וכי וכת ולה ולו ולי ולת"},e.suf={suf1:"ך כ ם ן נ",suf2:"ים ות וך וכ ום ון ונ הם הן יכ יך ינ ים",suf3:"תי תך תכ תם תן תנ",suf4:"ותי ותך ותכ ותם ותן ותנ",suf5:"נו כם כן הם הן",suf6:"ונו וכם וכן והם והן",suf7:"תכם תכן תנו תהם תהן",suf8:"הוא היא הם הן אני אתה את אנו אתם אתן",suf9:"ני נו כי כו כם כן תי תך תכ תם תן",suf10:"י ך כ ם ן נ ת"},e.patterns=JSON.parse('{"hebrewPatterns": [{"pt1": [{"c": "ה", "l": 0}]}, {"pt2": [{"c": "ו", "l": 0}]}, {"pt3": [{"c": "י", "l": 0}]}, {"pt4": [{"c": "ת", "l": 0}]}, {"pt5": [{"c": "מ", "l": 0}]}, {"pt6": [{"c": "ל", "l": 0}]}, {"pt7": [{"c": "ב", "l": 0}]}, {"pt8": [{"c": "כ", "l": 0}]}, {"pt9": [{"c": "ש", "l": 0}]}, {"pt10": [{"c": "כש", "l": 0}]}, {"pt11": [{"c": "בה", "l": 0}]}, {"pt12": [{"c": "וב", "l": 0}]}, {"pt13": [{"c": "וכ", "l": 0}]}, {"pt14": [{"c": "ול", "l": 0}]}, {"pt15": [{"c": "ומ", "l": 0}]}, {"pt16": [{"c": "וש", "l": 0}]}, {"pt17": [{"c": "הב", "l": 0}]}, {"pt18": [{"c": "הכ", "l": 0}]}, {"pt19": [{"c": "הל", "l": 0}]}, {"pt20": [{"c": "המ", "l": 0}]}, {"pt21": [{"c": "הש", "l": 0}]}, {"pt22": [{"c": "מה", "l": 0}]}, {"pt23": [{"c": "שה", "l": 0}]}, {"pt24": [{"c": "כל", "l": 0}]}]}'),e.execArray=["cleanWord","removeDiacritics","removeStopWords","normalizeHebrewCharacters"],e.stem=function(){var r=0;for(e.result=!1,e.preRemoved=!1,e.sufRemoved=!1;r=0)return!0},e.normalizeHebrewCharacters=function(){return e.word=e.word.replace("ך","כ"),e.word=e.word.replace("ם","מ"),e.word=e.word.replace("ן","נ"),e.word=e.word.replace("ף","פ"),e.word=e.word.replace("ץ","צ"),!1},function(r){return"function"==typeof r.update?r.update(function(r){return e.setCurrent(r),e.stem(),e.getCurrent()}):(e.setCurrent(r),e.stem(),e.getCurrent())}}(),e.Pipeline.registerFunction(e.he.stemmer,"stemmer-he"),e.he.stopWordFilter=e.generateStopWordFilter("אבל או אולי אותו אותי אותך אותם אותן אותנו אז אחר אחרות אחרי אחריכן אחרים אחרת אי איזה איך אין איפה אל אלה אלו אם אנחנו אני אף אפשר את אתה אתכם אתכן אתם אתן באיזה באיזו בגלל בין בלבד בעבור בעזרת בכל בכן בלי במידה במקום שבו ברוב בשביל בשעה ש בתוך גם דרך הוא היא היה היי היכן היתה היתי הם הן הנה הסיבה שבגללה הרי ואילו ואת זאת זה זות יהיה יוכל יוכלו יותר מדי יכול יכולה יכולות יכולים יכל יכלה יכלו יש כאן כאשר כולם כולן כזה כי כיצד כך כל כלל כמו כן כפי כש לא לאו לאיזותך לאן לבין לה להיות להם להן לו לזה לזות לי לך לכם לכן למה למעלה למעלה מ למטה למטה מ למעט למקום שבו למרות לנו לעבר לעיכן לפיכך לפני מאד מאחורי מאיזו סיבה מאין מאיפה מבלי מבעד מדוע מה מהיכן מול מחוץ מי מידע מכאן מכל מכן מלבד מן מנין מסוגל מעט מעטים מעל מצד מקום בו מתחת מתי נגד נגר נו עד עז על עלי עליו עליה עליהם עליך עלינו עם עצמה עצמהם עצמהן עצמו עצמי עצמם עצמן עצמנו פה רק שוב של שלה שלהם שלהן שלו שלי שלך שלכה שלכם שלכן שלנו שם תהיה תחת".split(" ")),e.Pipeline.registerFunction(e.he.stopWordFilter,"stopWordFilter-he")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.hi.min.js b/assets/javascripts/lunr/min/lunr.hi.min.js new file mode 100644 index 00000000..7dbc4140 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.hi.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hi=function(){this.pipeline.reset(),this.pipeline.add(e.hi.trimmer,e.hi.stopWordFilter,e.hi.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.hi.stemmer))},e.hi.wordCharacters="ऀ-ःऄ-एऐ-टठ-यर-िी-ॏॐ-य़ॠ-९॰-ॿa-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.hi.trimmer=e.trimmerSupport.generateTrimmer(e.hi.wordCharacters),e.Pipeline.registerFunction(e.hi.trimmer,"trimmer-hi"),e.hi.stopWordFilter=e.generateStopWordFilter("अत अपना अपनी अपने अभी अंदर आदि आप इत्यादि इन इनका इन्हीं इन्हें इन्हों इस इसका इसकी इसके इसमें इसी इसे उन उनका उनकी उनके उनको उन्हीं उन्हें उन्हों उस उसके उसी उसे एक एवं एस ऐसे और कई कर करता करते करना करने करें कहते कहा का काफ़ी कि कितना किन्हें किन्हों किया किर किस किसी किसे की कुछ कुल के को कोई कौन कौनसा गया घर जब जहाँ जा जितना जिन जिन्हें जिन्हों जिस जिसे जीधर जैसा जैसे जो तक तब तरह तिन तिन्हें तिन्हों तिस तिसे तो था थी थे दबारा दिया दुसरा दूसरे दो द्वारा न नके नहीं ना निहायत नीचे ने पर पहले पूरा पे फिर बनी बही बहुत बाद बाला बिलकुल भी भीतर मगर मानो मे में यदि यह यहाँ यही या यिह ये रखें रहा रहे ऱ्वासा लिए लिये लेकिन व वग़ैरह वर्ग वह वहाँ वहीं वाले वुह वे वो सकता सकते सबसे सभी साथ साबुत साभ सारा से सो संग ही हुआ हुई हुए है हैं हो होता होती होते होना होने".split(" ")),e.hi.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var r=e.wordcut;r.init(),e.hi.tokenizer=function(i){if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(r){return isLunr2?new e.Token(r.toLowerCase()):r.toLowerCase()});var t=i.toString().toLowerCase().replace(/^\s+/,"");return r.cut(t).split("|")},e.Pipeline.registerFunction(e.hi.stemmer,"stemmer-hi"),e.Pipeline.registerFunction(e.hi.stopWordFilter,"stopWordFilter-hi")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.hu.min.js b/assets/javascripts/lunr/min/lunr.hu.min.js new file mode 100644 index 00000000..ed9d909f --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.hu.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Hungarian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,n){"function"==typeof define&&define.amd?define(n):"object"==typeof exports?module.exports=n():n()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hu=function(){this.pipeline.reset(),this.pipeline.add(e.hu.trimmer,e.hu.stopWordFilter,e.hu.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.hu.stemmer))},e.hu.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.hu.trimmer=e.trimmerSupport.generateTrimmer(e.hu.wordCharacters),e.Pipeline.registerFunction(e.hu.trimmer,"trimmer-hu"),e.hu.stemmer=function(){var n=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,i=new function(){function e(){var e,n=L.cursor;if(d=L.limit,L.in_grouping(W,97,252))for(;;){if(e=L.cursor,L.out_grouping(W,97,252))return L.cursor=e,L.find_among(g,8)||(L.cursor=e,e=L.limit)return void(d=e);L.cursor++}if(L.cursor=n,L.out_grouping(W,97,252)){for(;!L.in_grouping(W,97,252);){if(L.cursor>=L.limit)return;L.cursor++}d=L.cursor}}function i(){return d<=L.cursor}function a(){var e;if(L.ket=L.cursor,(e=L.find_among_b(h,2))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("a");break;case 2:L.slice_from("e")}}function t(){var e=L.limit-L.cursor;return!!L.find_among_b(p,23)&&(L.cursor=L.limit-e,!0)}function s(){if(L.cursor>L.limit_backward){L.cursor--,L.ket=L.cursor;var e=L.cursor-1;L.limit_backward<=e&&e<=L.limit&&(L.cursor=e,L.bra=e,L.slice_del())}}function c(){var e;if(L.ket=L.cursor,(e=L.find_among_b(_,2))&&(L.bra=L.cursor,i())){if((1==e||2==e)&&!t())return;L.slice_del(),s()}}function o(){L.ket=L.cursor,L.find_among_b(v,44)&&(L.bra=L.cursor,i()&&(L.slice_del(),a()))}function w(){var e;if(L.ket=L.cursor,(e=L.find_among_b(z,3))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("e");break;case 2:case 3:L.slice_from("a")}}function l(){var e;if(L.ket=L.cursor,(e=L.find_among_b(y,6))&&(L.bra=L.cursor,i()))switch(e){case 1:case 2:L.slice_del();break;case 3:L.slice_from("a");break;case 4:L.slice_from("e")}}function u(){var e;if(L.ket=L.cursor,(e=L.find_among_b(j,2))&&(L.bra=L.cursor,i())){if((1==e||2==e)&&!t())return;L.slice_del(),s()}}function m(){var e;if(L.ket=L.cursor,(e=L.find_among_b(C,7))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("a");break;case 2:L.slice_from("e");break;case 3:case 4:case 5:case 6:case 7:L.slice_del()}}function k(){var e;if(L.ket=L.cursor,(e=L.find_among_b(P,12))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 7:case 9:L.slice_del();break;case 2:case 5:case 8:L.slice_from("e");break;case 3:case 6:L.slice_from("a")}}function f(){var e;if(L.ket=L.cursor,(e=L.find_among_b(F,31))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 7:case 8:case 9:case 12:case 13:case 16:case 17:case 18:L.slice_del();break;case 2:case 5:case 10:case 14:case 19:L.slice_from("a");break;case 3:case 6:case 11:case 15:case 20:L.slice_from("e")}}function b(){var e;if(L.ket=L.cursor,(e=L.find_among_b(S,42))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 5:case 6:case 9:case 10:case 11:case 14:case 15:case 16:case 17:case 20:case 21:case 24:case 25:case 26:case 29:L.slice_del();break;case 2:case 7:case 12:case 18:case 22:case 27:L.slice_from("a");break;case 3:case 8:case 13:case 19:case 23:case 28:L.slice_from("e")}}var d,g=[new n("cs",-1,-1),new n("dzs",-1,-1),new n("gy",-1,-1),new n("ly",-1,-1),new n("ny",-1,-1),new n("sz",-1,-1),new n("ty",-1,-1),new n("zs",-1,-1)],h=[new n("á",-1,1),new n("é",-1,2)],p=[new n("bb",-1,-1),new n("cc",-1,-1),new n("dd",-1,-1),new n("ff",-1,-1),new n("gg",-1,-1),new n("jj",-1,-1),new n("kk",-1,-1),new n("ll",-1,-1),new n("mm",-1,-1),new n("nn",-1,-1),new n("pp",-1,-1),new n("rr",-1,-1),new n("ccs",-1,-1),new n("ss",-1,-1),new n("zzs",-1,-1),new n("tt",-1,-1),new n("vv",-1,-1),new n("ggy",-1,-1),new n("lly",-1,-1),new n("nny",-1,-1),new n("tty",-1,-1),new n("ssz",-1,-1),new n("zz",-1,-1)],_=[new n("al",-1,1),new n("el",-1,2)],v=[new n("ba",-1,-1),new n("ra",-1,-1),new n("be",-1,-1),new n("re",-1,-1),new n("ig",-1,-1),new n("nak",-1,-1),new n("nek",-1,-1),new n("val",-1,-1),new n("vel",-1,-1),new n("ul",-1,-1),new n("nál",-1,-1),new n("nél",-1,-1),new n("ból",-1,-1),new n("ról",-1,-1),new n("tól",-1,-1),new n("bõl",-1,-1),new n("rõl",-1,-1),new n("tõl",-1,-1),new n("ül",-1,-1),new n("n",-1,-1),new n("an",19,-1),new n("ban",20,-1),new n("en",19,-1),new n("ben",22,-1),new n("képpen",22,-1),new n("on",19,-1),new n("ön",19,-1),new n("képp",-1,-1),new n("kor",-1,-1),new n("t",-1,-1),new n("at",29,-1),new n("et",29,-1),new n("ként",29,-1),new n("anként",32,-1),new n("enként",32,-1),new n("onként",32,-1),new n("ot",29,-1),new n("ért",29,-1),new n("öt",29,-1),new n("hez",-1,-1),new n("hoz",-1,-1),new n("höz",-1,-1),new n("vá",-1,-1),new n("vé",-1,-1)],z=[new n("án",-1,2),new n("én",-1,1),new n("ánként",-1,3)],y=[new n("stul",-1,2),new n("astul",0,1),new n("ástul",0,3),new n("stül",-1,2),new n("estül",3,1),new n("éstül",3,4)],j=[new n("á",-1,1),new n("é",-1,2)],C=[new n("k",-1,7),new n("ak",0,4),new n("ek",0,6),new n("ok",0,5),new n("ák",0,1),new n("ék",0,2),new n("ök",0,3)],P=[new n("éi",-1,7),new n("áéi",0,6),new n("ééi",0,5),new n("é",-1,9),new n("ké",3,4),new n("aké",4,1),new n("eké",4,1),new n("oké",4,1),new n("áké",4,3),new n("éké",4,2),new n("öké",4,1),new n("éé",3,8)],F=[new n("a",-1,18),new n("ja",0,17),new n("d",-1,16),new n("ad",2,13),new n("ed",2,13),new n("od",2,13),new n("ád",2,14),new n("éd",2,15),new n("öd",2,13),new n("e",-1,18),new n("je",9,17),new n("nk",-1,4),new n("unk",11,1),new n("ánk",11,2),new n("énk",11,3),new n("ünk",11,1),new n("uk",-1,8),new n("juk",16,7),new n("ájuk",17,5),new n("ük",-1,8),new n("jük",19,7),new n("éjük",20,6),new n("m",-1,12),new n("am",22,9),new n("em",22,9),new n("om",22,9),new n("ám",22,10),new n("ém",22,11),new n("o",-1,18),new n("á",-1,19),new n("é",-1,20)],S=[new n("id",-1,10),new n("aid",0,9),new n("jaid",1,6),new n("eid",0,9),new n("jeid",3,6),new n("áid",0,7),new n("éid",0,8),new n("i",-1,15),new n("ai",7,14),new n("jai",8,11),new n("ei",7,14),new n("jei",10,11),new n("ái",7,12),new n("éi",7,13),new n("itek",-1,24),new n("eitek",14,21),new n("jeitek",15,20),new n("éitek",14,23),new n("ik",-1,29),new n("aik",18,26),new n("jaik",19,25),new n("eik",18,26),new n("jeik",21,25),new n("áik",18,27),new n("éik",18,28),new n("ink",-1,20),new n("aink",25,17),new n("jaink",26,16),new n("eink",25,17),new n("jeink",28,16),new n("áink",25,18),new n("éink",25,19),new n("aitok",-1,21),new n("jaitok",32,20),new n("áitok",-1,22),new n("im",-1,5),new n("aim",35,4),new n("jaim",36,1),new n("eim",35,4),new n("jeim",38,1),new n("áim",35,2),new n("éim",35,3)],W=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,52,14],L=new r;this.setCurrent=function(e){L.setCurrent(e)},this.getCurrent=function(){return L.getCurrent()},this.stem=function(){var n=L.cursor;return e(),L.limit_backward=n,L.cursor=L.limit,c(),L.cursor=L.limit,o(),L.cursor=L.limit,w(),L.cursor=L.limit,l(),L.cursor=L.limit,u(),L.cursor=L.limit,k(),L.cursor=L.limit,f(),L.cursor=L.limit,b(),L.cursor=L.limit,m(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.hu.stemmer,"stemmer-hu"),e.hu.stopWordFilter=e.generateStopWordFilter("a abban ahhoz ahogy ahol aki akik akkor alatt amely amelyek amelyekben amelyeket amelyet amelynek ami amikor amit amolyan amíg annak arra arról az azok azon azonban azt aztán azután azzal azért be belül benne bár cikk cikkek cikkeket csak de e ebben eddig egy egyes egyetlen egyik egyre egyéb egész ehhez ekkor el ellen elsõ elég elõ elõször elõtt emilyen ennek erre ez ezek ezen ezt ezzel ezért fel felé hanem hiszen hogy hogyan igen ill ill. illetve ilyen ilyenkor ismét ison itt jobban jó jól kell kellett keressünk keresztül ki kívül között közül legalább legyen lehet lehetett lenne lenni lesz lett maga magát majd majd meg mellett mely melyek mert mi mikor milyen minden mindenki mindent mindig mint mintha mit mivel miért most már más másik még míg nagy nagyobb nagyon ne nekem neki nem nincs néha néhány nélkül olyan ott pedig persze rá s saját sem semmi sok sokat sokkal szemben szerint szinte számára talán tehát teljes tovább továbbá több ugyanis utolsó után utána vagy vagyis vagyok valaki valami valamint való van vannak vele vissza viszont volna volt voltak voltam voltunk által általában át én éppen és így õ õk õket össze úgy új újabb újra".split(" ")),e.Pipeline.registerFunction(e.hu.stopWordFilter,"stopWordFilter-hu")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.hy.min.js b/assets/javascripts/lunr/min/lunr.hy.min.js new file mode 100644 index 00000000..b37f7929 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.hy.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hy=function(){this.pipeline.reset(),this.pipeline.add(e.hy.trimmer,e.hy.stopWordFilter)},e.hy.wordCharacters="[A-Za-z԰-֏ff-ﭏ]",e.hy.trimmer=e.trimmerSupport.generateTrimmer(e.hy.wordCharacters),e.Pipeline.registerFunction(e.hy.trimmer,"trimmer-hy"),e.hy.stopWordFilter=e.generateStopWordFilter("դու և եք էիր էիք հետո նաև նրանք որը վրա է որ պիտի են այս մեջ ն իր ու ի այդ որոնք այն կամ էր մի ես համար այլ իսկ էին ենք հետ ին թ էինք մենք նրա նա դուք եմ էի ըստ որպես ում".split(" ")),e.Pipeline.registerFunction(e.hy.stopWordFilter,"stopWordFilter-hy"),e.hy.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}(),e.Pipeline.registerFunction(e.hy.stemmer,"stemmer-hy")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.it.min.js b/assets/javascripts/lunr/min/lunr.it.min.js new file mode 100644 index 00000000..344b6a3c --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.it.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Italian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.it=function(){this.pipeline.reset(),this.pipeline.add(e.it.trimmer,e.it.stopWordFilter,e.it.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.it.stemmer))},e.it.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.it.trimmer=e.trimmerSupport.generateTrimmer(e.it.wordCharacters),e.Pipeline.registerFunction(e.it.trimmer,"trimmer-it"),e.it.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,n){return!(!x.eq_s(1,e)||(x.ket=x.cursor,!x.in_grouping(L,97,249)))&&(x.slice_from(r),x.cursor=n,!0)}function i(){for(var r,n,i,o,t=x.cursor;;){if(x.bra=x.cursor,r=x.find_among(h,7))switch(x.ket=x.cursor,r){case 1:x.slice_from("à");continue;case 2:x.slice_from("è");continue;case 3:x.slice_from("ì");continue;case 4:x.slice_from("ò");continue;case 5:x.slice_from("ù");continue;case 6:x.slice_from("qU");continue;case 7:if(x.cursor>=x.limit)break;x.cursor++;continue}break}for(x.cursor=t;;)for(n=x.cursor;;){if(i=x.cursor,x.in_grouping(L,97,249)){if(x.bra=x.cursor,o=x.cursor,e("u","U",i))break;if(x.cursor=o,e("i","I",i))break}if(x.cursor=i,x.cursor>=x.limit)return void(x.cursor=n);x.cursor++}}function o(e){if(x.cursor=e,!x.in_grouping(L,97,249))return!1;for(;!x.out_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}return!0}function t(){if(x.in_grouping(L,97,249)){var e=x.cursor;if(x.out_grouping(L,97,249)){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return o(e);x.cursor++}return!0}return o(e)}return!1}function s(){var e,r=x.cursor;if(!t()){if(x.cursor=r,!x.out_grouping(L,97,249))return;if(e=x.cursor,x.out_grouping(L,97,249)){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return x.cursor=e,void(x.in_grouping(L,97,249)&&x.cursor=x.limit)return;x.cursor++}k=x.cursor}function a(){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}for(;!x.out_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}return!0}function u(){var e=x.cursor;k=x.limit,p=k,g=k,s(),x.cursor=e,a()&&(p=x.cursor,a()&&(g=x.cursor))}function c(){for(var e;;){if(x.bra=x.cursor,!(e=x.find_among(q,3)))break;switch(x.ket=x.cursor,e){case 1:x.slice_from("i");break;case 2:x.slice_from("u");break;case 3:if(x.cursor>=x.limit)return;x.cursor++}}}function w(){return k<=x.cursor}function l(){return p<=x.cursor}function m(){return g<=x.cursor}function f(){var e;if(x.ket=x.cursor,x.find_among_b(C,37)&&(x.bra=x.cursor,(e=x.find_among_b(z,5))&&w()))switch(e){case 1:x.slice_del();break;case 2:x.slice_from("e")}}function v(){var e;if(x.ket=x.cursor,!(e=x.find_among_b(S,51)))return!1;switch(x.bra=x.cursor,e){case 1:if(!m())return!1;x.slice_del();break;case 2:if(!m())return!1;x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"ic")&&(x.bra=x.cursor,m()&&x.slice_del());break;case 3:if(!m())return!1;x.slice_from("log");break;case 4:if(!m())return!1;x.slice_from("u");break;case 5:if(!m())return!1;x.slice_from("ente");break;case 6:if(!w())return!1;x.slice_del();break;case 7:if(!l())return!1;x.slice_del(),x.ket=x.cursor,e=x.find_among_b(P,4),e&&(x.bra=x.cursor,m()&&(x.slice_del(),1==e&&(x.ket=x.cursor,x.eq_s_b(2,"at")&&(x.bra=x.cursor,m()&&x.slice_del()))));break;case 8:if(!m())return!1;x.slice_del(),x.ket=x.cursor,e=x.find_among_b(F,3),e&&(x.bra=x.cursor,1==e&&m()&&x.slice_del());break;case 9:if(!m())return!1;x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"at")&&(x.bra=x.cursor,m()&&(x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"ic")&&(x.bra=x.cursor,m()&&x.slice_del())))}return!0}function b(){var e,r;x.cursor>=k&&(r=x.limit_backward,x.limit_backward=k,x.ket=x.cursor,e=x.find_among_b(W,87),e&&(x.bra=x.cursor,1==e&&x.slice_del()),x.limit_backward=r)}function d(){var e=x.limit-x.cursor;if(x.ket=x.cursor,x.in_grouping_b(y,97,242)&&(x.bra=x.cursor,w()&&(x.slice_del(),x.ket=x.cursor,x.eq_s_b(1,"i")&&(x.bra=x.cursor,w()))))return void x.slice_del();x.cursor=x.limit-e}function _(){d(),x.ket=x.cursor,x.eq_s_b(1,"h")&&(x.bra=x.cursor,x.in_grouping_b(U,99,103)&&w()&&x.slice_del())}var g,p,k,h=[new r("",-1,7),new r("qu",0,6),new r("á",0,1),new r("é",0,2),new r("í",0,3),new r("ó",0,4),new r("ú",0,5)],q=[new r("",-1,3),new r("I",0,1),new r("U",0,2)],C=[new r("la",-1,-1),new r("cela",0,-1),new r("gliela",0,-1),new r("mela",0,-1),new r("tela",0,-1),new r("vela",0,-1),new r("le",-1,-1),new r("cele",6,-1),new r("gliele",6,-1),new r("mele",6,-1),new r("tele",6,-1),new r("vele",6,-1),new r("ne",-1,-1),new r("cene",12,-1),new r("gliene",12,-1),new r("mene",12,-1),new r("sene",12,-1),new r("tene",12,-1),new r("vene",12,-1),new r("ci",-1,-1),new r("li",-1,-1),new r("celi",20,-1),new r("glieli",20,-1),new r("meli",20,-1),new r("teli",20,-1),new r("veli",20,-1),new r("gli",20,-1),new r("mi",-1,-1),new r("si",-1,-1),new r("ti",-1,-1),new r("vi",-1,-1),new r("lo",-1,-1),new r("celo",31,-1),new r("glielo",31,-1),new r("melo",31,-1),new r("telo",31,-1),new r("velo",31,-1)],z=[new r("ando",-1,1),new r("endo",-1,1),new r("ar",-1,2),new r("er",-1,2),new r("ir",-1,2)],P=[new r("ic",-1,-1),new r("abil",-1,-1),new r("os",-1,-1),new r("iv",-1,1)],F=[new r("ic",-1,1),new r("abil",-1,1),new r("iv",-1,1)],S=[new r("ica",-1,1),new r("logia",-1,3),new r("osa",-1,1),new r("ista",-1,1),new r("iva",-1,9),new r("anza",-1,1),new r("enza",-1,5),new r("ice",-1,1),new r("atrice",7,1),new r("iche",-1,1),new r("logie",-1,3),new r("abile",-1,1),new r("ibile",-1,1),new r("usione",-1,4),new r("azione",-1,2),new r("uzione",-1,4),new r("atore",-1,2),new r("ose",-1,1),new r("ante",-1,1),new r("mente",-1,1),new r("amente",19,7),new r("iste",-1,1),new r("ive",-1,9),new r("anze",-1,1),new r("enze",-1,5),new r("ici",-1,1),new r("atrici",25,1),new r("ichi",-1,1),new r("abili",-1,1),new r("ibili",-1,1),new r("ismi",-1,1),new r("usioni",-1,4),new r("azioni",-1,2),new r("uzioni",-1,4),new r("atori",-1,2),new r("osi",-1,1),new r("anti",-1,1),new r("amenti",-1,6),new r("imenti",-1,6),new r("isti",-1,1),new r("ivi",-1,9),new r("ico",-1,1),new r("ismo",-1,1),new r("oso",-1,1),new r("amento",-1,6),new r("imento",-1,6),new r("ivo",-1,9),new r("ità",-1,8),new r("istà",-1,1),new r("istè",-1,1),new r("istì",-1,1)],W=[new r("isca",-1,1),new r("enda",-1,1),new r("ata",-1,1),new r("ita",-1,1),new r("uta",-1,1),new r("ava",-1,1),new r("eva",-1,1),new r("iva",-1,1),new r("erebbe",-1,1),new r("irebbe",-1,1),new r("isce",-1,1),new r("ende",-1,1),new r("are",-1,1),new r("ere",-1,1),new r("ire",-1,1),new r("asse",-1,1),new r("ate",-1,1),new r("avate",16,1),new r("evate",16,1),new r("ivate",16,1),new r("ete",-1,1),new r("erete",20,1),new r("irete",20,1),new r("ite",-1,1),new r("ereste",-1,1),new r("ireste",-1,1),new r("ute",-1,1),new r("erai",-1,1),new r("irai",-1,1),new r("isci",-1,1),new r("endi",-1,1),new r("erei",-1,1),new r("irei",-1,1),new r("assi",-1,1),new r("ati",-1,1),new r("iti",-1,1),new r("eresti",-1,1),new r("iresti",-1,1),new r("uti",-1,1),new r("avi",-1,1),new r("evi",-1,1),new r("ivi",-1,1),new r("isco",-1,1),new r("ando",-1,1),new r("endo",-1,1),new r("Yamo",-1,1),new r("iamo",-1,1),new r("avamo",-1,1),new r("evamo",-1,1),new r("ivamo",-1,1),new r("eremo",-1,1),new r("iremo",-1,1),new r("assimo",-1,1),new r("ammo",-1,1),new r("emmo",-1,1),new r("eremmo",54,1),new r("iremmo",54,1),new r("immo",-1,1),new r("ano",-1,1),new r("iscano",58,1),new r("avano",58,1),new r("evano",58,1),new r("ivano",58,1),new r("eranno",-1,1),new r("iranno",-1,1),new r("ono",-1,1),new r("iscono",65,1),new r("arono",65,1),new r("erono",65,1),new r("irono",65,1),new r("erebbero",-1,1),new r("irebbero",-1,1),new r("assero",-1,1),new r("essero",-1,1),new r("issero",-1,1),new r("ato",-1,1),new r("ito",-1,1),new r("uto",-1,1),new r("avo",-1,1),new r("evo",-1,1),new r("ivo",-1,1),new r("ar",-1,1),new r("ir",-1,1),new r("erà",-1,1),new r("irà",-1,1),new r("erò",-1,1),new r("irò",-1,1)],L=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2,1],y=[17,65,0,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2],U=[17],x=new n;this.setCurrent=function(e){x.setCurrent(e)},this.getCurrent=function(){return x.getCurrent()},this.stem=function(){var e=x.cursor;return i(),x.cursor=e,u(),x.limit_backward=e,x.cursor=x.limit,f(),x.cursor=x.limit,v()||(x.cursor=x.limit,b()),x.cursor=x.limit,_(),x.cursor=x.limit_backward,c(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.it.stemmer,"stemmer-it"),e.it.stopWordFilter=e.generateStopWordFilter("a abbia abbiamo abbiano abbiate ad agl agli ai al all alla alle allo anche avemmo avendo avesse avessero avessi avessimo aveste avesti avete aveva avevamo avevano avevate avevi avevo avrai avranno avrebbe avrebbero avrei avremmo avremo avreste avresti avrete avrà avrò avuta avute avuti avuto c che chi ci coi col come con contro cui da dagl dagli dai dal dall dalla dalle dallo degl degli dei del dell della delle dello di dov dove e ebbe ebbero ebbi ed era erano eravamo eravate eri ero essendo faccia facciamo facciano facciate faccio facemmo facendo facesse facessero facessi facessimo faceste facesti faceva facevamo facevano facevate facevi facevo fai fanno farai faranno farebbe farebbero farei faremmo faremo fareste faresti farete farà farò fece fecero feci fosse fossero fossi fossimo foste fosti fu fui fummo furono gli ha hai hanno ho i il in io l la le lei li lo loro lui ma mi mia mie miei mio ne negl negli nei nel nell nella nelle nello noi non nostra nostre nostri nostro o per perché più quale quanta quante quanti quanto quella quelle quelli quello questa queste questi questo sarai saranno sarebbe sarebbero sarei saremmo saremo sareste saresti sarete sarà sarò se sei si sia siamo siano siate siete sono sta stai stando stanno starai staranno starebbe starebbero starei staremmo staremo stareste staresti starete starà starò stava stavamo stavano stavate stavi stavo stemmo stesse stessero stessi stessimo steste stesti stette stettero stetti stia stiamo stiano stiate sto su sua sue sugl sugli sui sul sull sulla sulle sullo suo suoi ti tra tu tua tue tuo tuoi tutti tutto un una uno vi voi vostra vostre vostri vostro è".split(" ")),e.Pipeline.registerFunction(e.it.stopWordFilter,"stopWordFilter-it")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.ja.min.js b/assets/javascripts/lunr/min/lunr.ja.min.js new file mode 100644 index 00000000..5f254ebe --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.ja.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var r="2"==e.version[0];e.ja=function(){this.pipeline.reset(),this.pipeline.add(e.ja.trimmer,e.ja.stopWordFilter,e.ja.stemmer),r?this.tokenizer=e.ja.tokenizer:(e.tokenizer&&(e.tokenizer=e.ja.tokenizer),this.tokenizerFn&&(this.tokenizerFn=e.ja.tokenizer))};var t=new e.TinySegmenter;e.ja.tokenizer=function(i){var n,o,s,p,a,u,m,l,c,f;if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(t){return r?new e.Token(t.toLowerCase()):t.toLowerCase()});for(o=i.toString().toLowerCase().replace(/^\s+/,""),n=o.length-1;n>=0;n--)if(/\S/.test(o.charAt(n))){o=o.substring(0,n+1);break}for(a=[],s=o.length,c=0,l=0;c<=s;c++)if(u=o.charAt(c),m=c-l,u.match(/\s/)||c==s){if(m>0)for(p=t.segment(o.slice(l,c)).filter(function(e){return!!e}),f=l,n=0;n=C.limit)break;C.cursor++;continue}break}for(C.cursor=o,C.bra=o,C.eq_s(1,"y")?(C.ket=C.cursor,C.slice_from("Y")):C.cursor=o;;)if(e=C.cursor,C.in_grouping(q,97,232)){if(i=C.cursor,C.bra=i,C.eq_s(1,"i"))C.ket=C.cursor,C.in_grouping(q,97,232)&&(C.slice_from("I"),C.cursor=e);else if(C.cursor=i,C.eq_s(1,"y"))C.ket=C.cursor,C.slice_from("Y"),C.cursor=e;else if(n(e))break}else if(n(e))break}function n(r){return C.cursor=r,r>=C.limit||(C.cursor++,!1)}function o(){_=C.limit,d=_,t()||(_=C.cursor,_<3&&(_=3),t()||(d=C.cursor))}function t(){for(;!C.in_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}for(;!C.out_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}return!1}function s(){for(var r;;)if(C.bra=C.cursor,r=C.find_among(p,3))switch(C.ket=C.cursor,r){case 1:C.slice_from("y");break;case 2:C.slice_from("i");break;case 3:if(C.cursor>=C.limit)return;C.cursor++}}function u(){return _<=C.cursor}function c(){return d<=C.cursor}function a(){var r=C.limit-C.cursor;C.find_among_b(g,3)&&(C.cursor=C.limit-r,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del()))}function l(){var r;w=!1,C.ket=C.cursor,C.eq_s_b(1,"e")&&(C.bra=C.cursor,u()&&(r=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-r,C.slice_del(),w=!0,a())))}function m(){var r;u()&&(r=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-r,C.eq_s_b(3,"gem")||(C.cursor=C.limit-r,C.slice_del(),a())))}function f(){var r,e,i,n,o,t,s=C.limit-C.cursor;if(C.ket=C.cursor,r=C.find_among_b(h,5))switch(C.bra=C.cursor,r){case 1:u()&&C.slice_from("heid");break;case 2:m();break;case 3:u()&&C.out_grouping_b(j,97,232)&&C.slice_del()}if(C.cursor=C.limit-s,l(),C.cursor=C.limit-s,C.ket=C.cursor,C.eq_s_b(4,"heid")&&(C.bra=C.cursor,c()&&(e=C.limit-C.cursor,C.eq_s_b(1,"c")||(C.cursor=C.limit-e,C.slice_del(),C.ket=C.cursor,C.eq_s_b(2,"en")&&(C.bra=C.cursor,m())))),C.cursor=C.limit-s,C.ket=C.cursor,r=C.find_among_b(k,6))switch(C.bra=C.cursor,r){case 1:if(c()){if(C.slice_del(),i=C.limit-C.cursor,C.ket=C.cursor,C.eq_s_b(2,"ig")&&(C.bra=C.cursor,c()&&(n=C.limit-C.cursor,!C.eq_s_b(1,"e")))){C.cursor=C.limit-n,C.slice_del();break}C.cursor=C.limit-i,a()}break;case 2:c()&&(o=C.limit-C.cursor,C.eq_s_b(1,"e")||(C.cursor=C.limit-o,C.slice_del()));break;case 3:c()&&(C.slice_del(),l());break;case 4:c()&&C.slice_del();break;case 5:c()&&w&&C.slice_del()}C.cursor=C.limit-s,C.out_grouping_b(z,73,232)&&(t=C.limit-C.cursor,C.find_among_b(v,4)&&C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-t,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del())))}var d,_,w,b=[new e("",-1,6),new e("á",0,1),new e("ä",0,1),new e("é",0,2),new e("ë",0,2),new e("í",0,3),new e("ï",0,3),new e("ó",0,4),new e("ö",0,4),new e("ú",0,5),new e("ü",0,5)],p=[new e("",-1,3),new e("I",0,2),new e("Y",0,1)],g=[new e("dd",-1,-1),new e("kk",-1,-1),new e("tt",-1,-1)],h=[new e("ene",-1,2),new e("se",-1,3),new e("en",-1,2),new e("heden",2,1),new e("s",-1,3)],k=[new e("end",-1,1),new e("ig",-1,2),new e("ing",-1,1),new e("lijk",-1,3),new e("baar",-1,4),new e("bar",-1,5)],v=[new e("aa",-1,-1),new e("ee",-1,-1),new e("oo",-1,-1),new e("uu",-1,-1)],q=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],z=[1,0,0,17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],j=[17,67,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],C=new i;this.setCurrent=function(r){C.setCurrent(r)},this.getCurrent=function(){return C.getCurrent()},this.stem=function(){var e=C.cursor;return r(),C.cursor=e,o(),C.limit_backward=e,C.cursor=C.limit,f(),C.cursor=C.limit_backward,s(),!0}};return function(r){return"function"==typeof r.update?r.update(function(r){return n.setCurrent(r),n.stem(),n.getCurrent()}):(n.setCurrent(r),n.stem(),n.getCurrent())}}(),r.Pipeline.registerFunction(r.nl.stemmer,"stemmer-nl"),r.nl.stopWordFilter=r.generateStopWordFilter(" aan al alles als altijd andere ben bij daar dan dat de der deze die dit doch doen door dus een eens en er ge geen geweest haar had heb hebben heeft hem het hier hij hoe hun iemand iets ik in is ja je kan kon kunnen maar me meer men met mij mijn moet na naar niet niets nog nu of om omdat onder ons ook op over reeds te tegen toch toen tot u uit uw van veel voor want waren was wat werd wezen wie wil worden wordt zal ze zelf zich zij zijn zo zonder zou".split(" ")),r.Pipeline.registerFunction(r.nl.stopWordFilter,"stopWordFilter-nl")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.no.min.js b/assets/javascripts/lunr/min/lunr.no.min.js new file mode 100644 index 00000000..92bc7e4e --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.no.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Norwegian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.no=function(){this.pipeline.reset(),this.pipeline.add(e.no.trimmer,e.no.stopWordFilter,e.no.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.no.stemmer))},e.no.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.no.trimmer=e.trimmerSupport.generateTrimmer(e.no.wordCharacters),e.Pipeline.registerFunction(e.no.trimmer,"trimmer-no"),e.no.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(){var e,r=w.cursor+3;if(a=w.limit,0<=r||r<=w.limit){for(s=r;;){if(e=w.cursor,w.in_grouping(d,97,248)){w.cursor=e;break}if(e>=w.limit)return;w.cursor=e+1}for(;!w.out_grouping(d,97,248);){if(w.cursor>=w.limit)return;w.cursor++}a=w.cursor,a=a&&(r=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,e=w.find_among_b(m,29),w.limit_backward=r,e))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:n=w.limit-w.cursor,w.in_grouping_b(c,98,122)?w.slice_del():(w.cursor=w.limit-n,w.eq_s_b(1,"k")&&w.out_grouping_b(d,97,248)&&w.slice_del());break;case 3:w.slice_from("er")}}function t(){var e,r=w.limit-w.cursor;w.cursor>=a&&(e=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,w.find_among_b(u,2)?(w.bra=w.cursor,w.limit_backward=e,w.cursor=w.limit-r,w.cursor>w.limit_backward&&(w.cursor--,w.bra=w.cursor,w.slice_del())):w.limit_backward=e)}function o(){var e,r;w.cursor>=a&&(r=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,e=w.find_among_b(l,11),e?(w.bra=w.cursor,w.limit_backward=r,1==e&&w.slice_del()):w.limit_backward=r)}var s,a,m=[new r("a",-1,1),new r("e",-1,1),new r("ede",1,1),new r("ande",1,1),new r("ende",1,1),new r("ane",1,1),new r("ene",1,1),new r("hetene",6,1),new r("erte",1,3),new r("en",-1,1),new r("heten",9,1),new r("ar",-1,1),new r("er",-1,1),new r("heter",12,1),new r("s",-1,2),new r("as",14,1),new r("es",14,1),new r("edes",16,1),new r("endes",16,1),new r("enes",16,1),new r("hetenes",19,1),new r("ens",14,1),new r("hetens",21,1),new r("ers",14,1),new r("ets",14,1),new r("et",-1,1),new r("het",25,1),new r("ert",-1,3),new r("ast",-1,1)],u=[new r("dt",-1,-1),new r("vt",-1,-1)],l=[new r("leg",-1,1),new r("eleg",0,1),new r("ig",-1,1),new r("eig",2,1),new r("lig",2,1),new r("elig",4,1),new r("els",-1,1),new r("lov",-1,1),new r("elov",7,1),new r("slov",7,1),new r("hetslov",9,1)],d=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128],c=[119,125,149,1],w=new n;this.setCurrent=function(e){w.setCurrent(e)},this.getCurrent=function(){return w.getCurrent()},this.stem=function(){var r=w.cursor;return e(),w.limit_backward=r,w.cursor=w.limit,i(),w.cursor=w.limit,t(),w.cursor=w.limit,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.no.stemmer,"stemmer-no"),e.no.stopWordFilter=e.generateStopWordFilter("alle at av bare begge ble blei bli blir blitt både båe da de deg dei deim deira deires dem den denne der dere deres det dette di din disse ditt du dykk dykkar då eg ein eit eitt eller elles en enn er et ett etter for fordi fra før ha hadde han hans har hennar henne hennes her hjå ho hoe honom hoss hossen hun hva hvem hver hvilke hvilken hvis hvor hvordan hvorfor i ikke ikkje ikkje ingen ingi inkje inn inni ja jeg kan kom korleis korso kun kunne kva kvar kvarhelst kven kvi kvifor man mange me med medan meg meget mellom men mi min mine mitt mot mykje ned no noe noen noka noko nokon nokor nokre nå når og også om opp oss over på samme seg selv si si sia sidan siden sin sine sitt sjøl skal skulle slik so som som somme somt så sånn til um upp ut uten var vart varte ved vere verte vi vil ville vore vors vort vår være være vært å".split(" ")),e.Pipeline.registerFunction(e.no.stopWordFilter,"stopWordFilter-no")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.pt.min.js b/assets/javascripts/lunr/min/lunr.pt.min.js new file mode 100644 index 00000000..6c16996d --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.pt.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Portuguese` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.pt=function(){this.pipeline.reset(),this.pipeline.add(e.pt.trimmer,e.pt.stopWordFilter,e.pt.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.pt.stemmer))},e.pt.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.pt.trimmer=e.trimmerSupport.generateTrimmer(e.pt.wordCharacters),e.Pipeline.registerFunction(e.pt.trimmer,"trimmer-pt"),e.pt.stemmer=function(){var r=e.stemmerSupport.Among,s=e.stemmerSupport.SnowballProgram,n=new function(){function e(){for(var e;;){if(z.bra=z.cursor,e=z.find_among(k,3))switch(z.ket=z.cursor,e){case 1:z.slice_from("a~");continue;case 2:z.slice_from("o~");continue;case 3:if(z.cursor>=z.limit)break;z.cursor++;continue}break}}function n(){if(z.out_grouping(y,97,250)){for(;!z.in_grouping(y,97,250);){if(z.cursor>=z.limit)return!0;z.cursor++}return!1}return!0}function i(){if(z.in_grouping(y,97,250))for(;!z.out_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}return g=z.cursor,!0}function o(){var e,r,s=z.cursor;if(z.in_grouping(y,97,250))if(e=z.cursor,n()){if(z.cursor=e,i())return}else g=z.cursor;if(z.cursor=s,z.out_grouping(y,97,250)){if(r=z.cursor,n()){if(z.cursor=r,!z.in_grouping(y,97,250)||z.cursor>=z.limit)return;z.cursor++}g=z.cursor}}function t(){for(;!z.in_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}for(;!z.out_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}return!0}function a(){var e=z.cursor;g=z.limit,b=g,h=g,o(),z.cursor=e,t()&&(b=z.cursor,t()&&(h=z.cursor))}function u(){for(var e;;){if(z.bra=z.cursor,e=z.find_among(q,3))switch(z.ket=z.cursor,e){case 1:z.slice_from("ã");continue;case 2:z.slice_from("õ");continue;case 3:if(z.cursor>=z.limit)break;z.cursor++;continue}break}}function w(){return g<=z.cursor}function m(){return b<=z.cursor}function c(){return h<=z.cursor}function l(){var e;if(z.ket=z.cursor,!(e=z.find_among_b(F,45)))return!1;switch(z.bra=z.cursor,e){case 1:if(!c())return!1;z.slice_del();break;case 2:if(!c())return!1;z.slice_from("log");break;case 3:if(!c())return!1;z.slice_from("u");break;case 4:if(!c())return!1;z.slice_from("ente");break;case 5:if(!m())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(j,4),e&&(z.bra=z.cursor,c()&&(z.slice_del(),1==e&&(z.ket=z.cursor,z.eq_s_b(2,"at")&&(z.bra=z.cursor,c()&&z.slice_del()))));break;case 6:if(!c())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(C,3),e&&(z.bra=z.cursor,1==e&&c()&&z.slice_del());break;case 7:if(!c())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(P,3),e&&(z.bra=z.cursor,1==e&&c()&&z.slice_del());break;case 8:if(!c())return!1;z.slice_del(),z.ket=z.cursor,z.eq_s_b(2,"at")&&(z.bra=z.cursor,c()&&z.slice_del());break;case 9:if(!w()||!z.eq_s_b(1,"e"))return!1;z.slice_from("ir")}return!0}function f(){var e,r;if(z.cursor>=g){if(r=z.limit_backward,z.limit_backward=g,z.ket=z.cursor,e=z.find_among_b(S,120))return z.bra=z.cursor,1==e&&z.slice_del(),z.limit_backward=r,!0;z.limit_backward=r}return!1}function d(){var e;z.ket=z.cursor,(e=z.find_among_b(W,7))&&(z.bra=z.cursor,1==e&&w()&&z.slice_del())}function v(e,r){if(z.eq_s_b(1,e)){z.bra=z.cursor;var s=z.limit-z.cursor;if(z.eq_s_b(1,r))return z.cursor=z.limit-s,w()&&z.slice_del(),!1}return!0}function p(){var e;if(z.ket=z.cursor,e=z.find_among_b(L,4))switch(z.bra=z.cursor,e){case 1:w()&&(z.slice_del(),z.ket=z.cursor,z.limit-z.cursor,v("u","g")&&v("i","c"));break;case 2:z.slice_from("c")}}function _(){if(!l()&&(z.cursor=z.limit,!f()))return z.cursor=z.limit,void d();z.cursor=z.limit,z.ket=z.cursor,z.eq_s_b(1,"i")&&(z.bra=z.cursor,z.eq_s_b(1,"c")&&(z.cursor=z.limit,w()&&z.slice_del()))}var h,b,g,k=[new r("",-1,3),new r("ã",0,1),new r("õ",0,2)],q=[new r("",-1,3),new r("a~",0,1),new r("o~",0,2)],j=[new r("ic",-1,-1),new r("ad",-1,-1),new r("os",-1,-1),new r("iv",-1,1)],C=[new r("ante",-1,1),new r("avel",-1,1),new r("ível",-1,1)],P=[new r("ic",-1,1),new r("abil",-1,1),new r("iv",-1,1)],F=[new r("ica",-1,1),new r("ância",-1,1),new r("ência",-1,4),new r("ira",-1,9),new r("adora",-1,1),new r("osa",-1,1),new r("ista",-1,1),new r("iva",-1,8),new r("eza",-1,1),new r("logía",-1,2),new r("idade",-1,7),new r("ante",-1,1),new r("mente",-1,6),new r("amente",12,5),new r("ável",-1,1),new r("ível",-1,1),new r("ución",-1,3),new r("ico",-1,1),new r("ismo",-1,1),new r("oso",-1,1),new r("amento",-1,1),new r("imento",-1,1),new r("ivo",-1,8),new r("aça~o",-1,1),new r("ador",-1,1),new r("icas",-1,1),new r("ências",-1,4),new r("iras",-1,9),new r("adoras",-1,1),new r("osas",-1,1),new r("istas",-1,1),new r("ivas",-1,8),new r("ezas",-1,1),new r("logías",-1,2),new r("idades",-1,7),new r("uciones",-1,3),new r("adores",-1,1),new r("antes",-1,1),new r("aço~es",-1,1),new r("icos",-1,1),new r("ismos",-1,1),new r("osos",-1,1),new r("amentos",-1,1),new r("imentos",-1,1),new r("ivos",-1,8)],S=[new r("ada",-1,1),new r("ida",-1,1),new r("ia",-1,1),new r("aria",2,1),new r("eria",2,1),new r("iria",2,1),new r("ara",-1,1),new r("era",-1,1),new r("ira",-1,1),new r("ava",-1,1),new r("asse",-1,1),new r("esse",-1,1),new r("isse",-1,1),new r("aste",-1,1),new r("este",-1,1),new r("iste",-1,1),new r("ei",-1,1),new r("arei",16,1),new r("erei",16,1),new r("irei",16,1),new r("am",-1,1),new r("iam",20,1),new r("ariam",21,1),new r("eriam",21,1),new r("iriam",21,1),new r("aram",20,1),new r("eram",20,1),new r("iram",20,1),new r("avam",20,1),new r("em",-1,1),new r("arem",29,1),new r("erem",29,1),new r("irem",29,1),new r("assem",29,1),new r("essem",29,1),new r("issem",29,1),new r("ado",-1,1),new r("ido",-1,1),new r("ando",-1,1),new r("endo",-1,1),new r("indo",-1,1),new r("ara~o",-1,1),new r("era~o",-1,1),new r("ira~o",-1,1),new r("ar",-1,1),new r("er",-1,1),new r("ir",-1,1),new r("as",-1,1),new r("adas",47,1),new r("idas",47,1),new r("ias",47,1),new r("arias",50,1),new r("erias",50,1),new r("irias",50,1),new r("aras",47,1),new r("eras",47,1),new r("iras",47,1),new r("avas",47,1),new r("es",-1,1),new r("ardes",58,1),new r("erdes",58,1),new r("irdes",58,1),new r("ares",58,1),new r("eres",58,1),new r("ires",58,1),new r("asses",58,1),new r("esses",58,1),new r("isses",58,1),new r("astes",58,1),new r("estes",58,1),new r("istes",58,1),new r("is",-1,1),new r("ais",71,1),new r("eis",71,1),new r("areis",73,1),new r("ereis",73,1),new r("ireis",73,1),new r("áreis",73,1),new r("éreis",73,1),new r("íreis",73,1),new r("ásseis",73,1),new r("ésseis",73,1),new r("ísseis",73,1),new r("áveis",73,1),new r("íeis",73,1),new r("aríeis",84,1),new r("eríeis",84,1),new r("iríeis",84,1),new r("ados",-1,1),new r("idos",-1,1),new r("amos",-1,1),new r("áramos",90,1),new r("éramos",90,1),new r("íramos",90,1),new r("ávamos",90,1),new r("íamos",90,1),new r("aríamos",95,1),new r("eríamos",95,1),new r("iríamos",95,1),new r("emos",-1,1),new r("aremos",99,1),new r("eremos",99,1),new r("iremos",99,1),new r("ássemos",99,1),new r("êssemos",99,1),new r("íssemos",99,1),new r("imos",-1,1),new r("armos",-1,1),new r("ermos",-1,1),new r("irmos",-1,1),new r("ámos",-1,1),new r("arás",-1,1),new r("erás",-1,1),new r("irás",-1,1),new r("eu",-1,1),new r("iu",-1,1),new r("ou",-1,1),new r("ará",-1,1),new r("erá",-1,1),new r("irá",-1,1)],W=[new r("a",-1,1),new r("i",-1,1),new r("o",-1,1),new r("os",-1,1),new r("á",-1,1),new r("í",-1,1),new r("ó",-1,1)],L=[new r("e",-1,1),new r("ç",-1,2),new r("é",-1,1),new r("ê",-1,1)],y=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,3,19,12,2],z=new s;this.setCurrent=function(e){z.setCurrent(e)},this.getCurrent=function(){return z.getCurrent()},this.stem=function(){var r=z.cursor;return e(),z.cursor=r,a(),z.limit_backward=r,z.cursor=z.limit,_(),z.cursor=z.limit,p(),z.cursor=z.limit_backward,u(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.pt.stemmer,"stemmer-pt"),e.pt.stopWordFilter=e.generateStopWordFilter("a ao aos aquela aquelas aquele aqueles aquilo as até com como da das de dela delas dele deles depois do dos e ela elas ele eles em entre era eram essa essas esse esses esta estamos estas estava estavam este esteja estejam estejamos estes esteve estive estivemos estiver estivera estiveram estiverem estivermos estivesse estivessem estivéramos estivéssemos estou está estávamos estão eu foi fomos for fora foram forem formos fosse fossem fui fôramos fôssemos haja hajam hajamos havemos hei houve houvemos houver houvera houveram houverei houverem houveremos houveria houveriam houvermos houverá houverão houveríamos houvesse houvessem houvéramos houvéssemos há hão isso isto já lhe lhes mais mas me mesmo meu meus minha minhas muito na nas nem no nos nossa nossas nosso nossos num numa não nós o os ou para pela pelas pelo pelos por qual quando que quem se seja sejam sejamos sem serei seremos seria seriam será serão seríamos seu seus somos sou sua suas são só também te tem temos tenha tenham tenhamos tenho terei teremos teria teriam terá terão teríamos teu teus teve tinha tinham tive tivemos tiver tivera tiveram tiverem tivermos tivesse tivessem tivéramos tivéssemos tu tua tuas tém tínhamos um uma você vocês vos à às éramos".split(" ")),e.Pipeline.registerFunction(e.pt.stopWordFilter,"stopWordFilter-pt")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.ro.min.js b/assets/javascripts/lunr/min/lunr.ro.min.js new file mode 100644 index 00000000..72771401 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.ro.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Romanian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,i){"function"==typeof define&&define.amd?define(i):"object"==typeof exports?module.exports=i():i()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ro=function(){this.pipeline.reset(),this.pipeline.add(e.ro.trimmer,e.ro.stopWordFilter,e.ro.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ro.stemmer))},e.ro.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.ro.trimmer=e.trimmerSupport.generateTrimmer(e.ro.wordCharacters),e.Pipeline.registerFunction(e.ro.trimmer,"trimmer-ro"),e.ro.stemmer=function(){var i=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,n=new function(){function e(e,i){L.eq_s(1,e)&&(L.ket=L.cursor,L.in_grouping(W,97,259)&&L.slice_from(i))}function n(){for(var i,r;;){if(i=L.cursor,L.in_grouping(W,97,259)&&(r=L.cursor,L.bra=r,e("u","U"),L.cursor=r,e("i","I")),L.cursor=i,L.cursor>=L.limit)break;L.cursor++}}function t(){if(L.out_grouping(W,97,259)){for(;!L.in_grouping(W,97,259);){if(L.cursor>=L.limit)return!0;L.cursor++}return!1}return!0}function a(){if(L.in_grouping(W,97,259))for(;!L.out_grouping(W,97,259);){if(L.cursor>=L.limit)return!0;L.cursor++}return!1}function o(){var e,i,r=L.cursor;if(L.in_grouping(W,97,259)){if(e=L.cursor,!t())return void(h=L.cursor);if(L.cursor=e,!a())return void(h=L.cursor)}L.cursor=r,L.out_grouping(W,97,259)&&(i=L.cursor,t()&&(L.cursor=i,L.in_grouping(W,97,259)&&L.cursor=L.limit)return!1;L.cursor++}for(;!L.out_grouping(W,97,259);){if(L.cursor>=L.limit)return!1;L.cursor++}return!0}function c(){var e=L.cursor;h=L.limit,k=h,g=h,o(),L.cursor=e,u()&&(k=L.cursor,u()&&(g=L.cursor))}function s(){for(var e;;){if(L.bra=L.cursor,e=L.find_among(z,3))switch(L.ket=L.cursor,e){case 1:L.slice_from("i");continue;case 2:L.slice_from("u");continue;case 3:if(L.cursor>=L.limit)break;L.cursor++;continue}break}}function w(){return h<=L.cursor}function m(){return k<=L.cursor}function l(){return g<=L.cursor}function f(){var e,i;if(L.ket=L.cursor,(e=L.find_among_b(C,16))&&(L.bra=L.cursor,m()))switch(e){case 1:L.slice_del();break;case 2:L.slice_from("a");break;case 3:L.slice_from("e");break;case 4:L.slice_from("i");break;case 5:i=L.limit-L.cursor,L.eq_s_b(2,"ab")||(L.cursor=L.limit-i,L.slice_from("i"));break;case 6:L.slice_from("at");break;case 7:L.slice_from("aţi")}}function p(){var e,i=L.limit-L.cursor;if(L.ket=L.cursor,(e=L.find_among_b(P,46))&&(L.bra=L.cursor,m())){switch(e){case 1:L.slice_from("abil");break;case 2:L.slice_from("ibil");break;case 3:L.slice_from("iv");break;case 4:L.slice_from("ic");break;case 5:L.slice_from("at");break;case 6:L.slice_from("it")}return _=!0,L.cursor=L.limit-i,!0}return!1}function d(){var e,i;for(_=!1;;)if(i=L.limit-L.cursor,!p()){L.cursor=L.limit-i;break}if(L.ket=L.cursor,(e=L.find_among_b(F,62))&&(L.bra=L.cursor,l())){switch(e){case 1:L.slice_del();break;case 2:L.eq_s_b(1,"ţ")&&(L.bra=L.cursor,L.slice_from("t"));break;case 3:L.slice_from("ist")}_=!0}}function b(){var e,i,r;if(L.cursor>=h){if(i=L.limit_backward,L.limit_backward=h,L.ket=L.cursor,e=L.find_among_b(q,94))switch(L.bra=L.cursor,e){case 1:if(r=L.limit-L.cursor,!L.out_grouping_b(W,97,259)&&(L.cursor=L.limit-r,!L.eq_s_b(1,"u")))break;case 2:L.slice_del()}L.limit_backward=i}}function v(){var e;L.ket=L.cursor,(e=L.find_among_b(S,5))&&(L.bra=L.cursor,w()&&1==e&&L.slice_del())}var _,g,k,h,z=[new i("",-1,3),new i("I",0,1),new i("U",0,2)],C=[new i("ea",-1,3),new i("aţia",-1,7),new i("aua",-1,2),new i("iua",-1,4),new i("aţie",-1,7),new i("ele",-1,3),new i("ile",-1,5),new i("iile",6,4),new i("iei",-1,4),new i("atei",-1,6),new i("ii",-1,4),new i("ului",-1,1),new i("ul",-1,1),new i("elor",-1,3),new i("ilor",-1,4),new i("iilor",14,4)],P=[new i("icala",-1,4),new i("iciva",-1,4),new i("ativa",-1,5),new i("itiva",-1,6),new i("icale",-1,4),new i("aţiune",-1,5),new i("iţiune",-1,6),new i("atoare",-1,5),new i("itoare",-1,6),new i("ătoare",-1,5),new i("icitate",-1,4),new i("abilitate",-1,1),new i("ibilitate",-1,2),new i("ivitate",-1,3),new i("icive",-1,4),new i("ative",-1,5),new i("itive",-1,6),new i("icali",-1,4),new i("atori",-1,5),new i("icatori",18,4),new i("itori",-1,6),new i("ători",-1,5),new i("icitati",-1,4),new i("abilitati",-1,1),new i("ivitati",-1,3),new i("icivi",-1,4),new i("ativi",-1,5),new i("itivi",-1,6),new i("icităi",-1,4),new i("abilităi",-1,1),new i("ivităi",-1,3),new i("icităţi",-1,4),new i("abilităţi",-1,1),new i("ivităţi",-1,3),new i("ical",-1,4),new i("ator",-1,5),new i("icator",35,4),new i("itor",-1,6),new i("ător",-1,5),new i("iciv",-1,4),new i("ativ",-1,5),new i("itiv",-1,6),new i("icală",-1,4),new i("icivă",-1,4),new i("ativă",-1,5),new i("itivă",-1,6)],F=[new i("ica",-1,1),new i("abila",-1,1),new i("ibila",-1,1),new i("oasa",-1,1),new i("ata",-1,1),new i("ita",-1,1),new i("anta",-1,1),new i("ista",-1,3),new i("uta",-1,1),new i("iva",-1,1),new i("ic",-1,1),new i("ice",-1,1),new i("abile",-1,1),new i("ibile",-1,1),new i("isme",-1,3),new i("iune",-1,2),new i("oase",-1,1),new i("ate",-1,1),new i("itate",17,1),new i("ite",-1,1),new i("ante",-1,1),new i("iste",-1,3),new i("ute",-1,1),new i("ive",-1,1),new i("ici",-1,1),new i("abili",-1,1),new i("ibili",-1,1),new i("iuni",-1,2),new i("atori",-1,1),new i("osi",-1,1),new i("ati",-1,1),new i("itati",30,1),new i("iti",-1,1),new i("anti",-1,1),new i("isti",-1,3),new i("uti",-1,1),new i("işti",-1,3),new i("ivi",-1,1),new i("ităi",-1,1),new i("oşi",-1,1),new i("ităţi",-1,1),new i("abil",-1,1),new i("ibil",-1,1),new i("ism",-1,3),new i("ator",-1,1),new i("os",-1,1),new i("at",-1,1),new i("it",-1,1),new i("ant",-1,1),new i("ist",-1,3),new i("ut",-1,1),new i("iv",-1,1),new i("ică",-1,1),new i("abilă",-1,1),new i("ibilă",-1,1),new i("oasă",-1,1),new i("ată",-1,1),new i("ită",-1,1),new i("antă",-1,1),new i("istă",-1,3),new i("ută",-1,1),new i("ivă",-1,1)],q=[new i("ea",-1,1),new i("ia",-1,1),new i("esc",-1,1),new i("ăsc",-1,1),new i("ind",-1,1),new i("ând",-1,1),new i("are",-1,1),new i("ere",-1,1),new i("ire",-1,1),new i("âre",-1,1),new i("se",-1,2),new i("ase",10,1),new i("sese",10,2),new i("ise",10,1),new i("use",10,1),new i("âse",10,1),new i("eşte",-1,1),new i("ăşte",-1,1),new i("eze",-1,1),new i("ai",-1,1),new i("eai",19,1),new i("iai",19,1),new i("sei",-1,2),new i("eşti",-1,1),new i("ăşti",-1,1),new i("ui",-1,1),new i("ezi",-1,1),new i("âi",-1,1),new i("aşi",-1,1),new i("seşi",-1,2),new i("aseşi",29,1),new i("seseşi",29,2),new i("iseşi",29,1),new i("useşi",29,1),new i("âseşi",29,1),new i("işi",-1,1),new i("uşi",-1,1),new i("âşi",-1,1),new i("aţi",-1,2),new i("eaţi",38,1),new i("iaţi",38,1),new i("eţi",-1,2),new i("iţi",-1,2),new i("âţi",-1,2),new i("arăţi",-1,1),new i("serăţi",-1,2),new i("aserăţi",45,1),new i("seserăţi",45,2),new i("iserăţi",45,1),new i("userăţi",45,1),new i("âserăţi",45,1),new i("irăţi",-1,1),new i("urăţi",-1,1),new i("ârăţi",-1,1),new i("am",-1,1),new i("eam",54,1),new i("iam",54,1),new i("em",-1,2),new i("asem",57,1),new i("sesem",57,2),new i("isem",57,1),new i("usem",57,1),new i("âsem",57,1),new i("im",-1,2),new i("âm",-1,2),new i("ăm",-1,2),new i("arăm",65,1),new i("serăm",65,2),new i("aserăm",67,1),new i("seserăm",67,2),new i("iserăm",67,1),new i("userăm",67,1),new i("âserăm",67,1),new i("irăm",65,1),new i("urăm",65,1),new i("ârăm",65,1),new i("au",-1,1),new i("eau",76,1),new i("iau",76,1),new i("indu",-1,1),new i("ându",-1,1),new i("ez",-1,1),new i("ească",-1,1),new i("ară",-1,1),new i("seră",-1,2),new i("aseră",84,1),new i("seseră",84,2),new i("iseră",84,1),new i("useră",84,1),new i("âseră",84,1),new i("iră",-1,1),new i("ură",-1,1),new i("âră",-1,1),new i("ează",-1,1)],S=[new i("a",-1,1),new i("e",-1,1),new i("ie",1,1),new i("i",-1,1),new i("ă",-1,1)],W=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,2,32,0,0,4],L=new r;this.setCurrent=function(e){L.setCurrent(e)},this.getCurrent=function(){return L.getCurrent()},this.stem=function(){var e=L.cursor;return n(),L.cursor=e,c(),L.limit_backward=e,L.cursor=L.limit,f(),L.cursor=L.limit,d(),L.cursor=L.limit,_||(L.cursor=L.limit,b(),L.cursor=L.limit),v(),L.cursor=L.limit_backward,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.ro.stemmer,"stemmer-ro"),e.ro.stopWordFilter=e.generateStopWordFilter("acea aceasta această aceea acei aceia acel acela acele acelea acest acesta aceste acestea aceşti aceştia acolo acord acum ai aia aibă aici al ale alea altceva altcineva am ar are asemenea asta astea astăzi asupra au avea avem aveţi azi aş aşadar aţi bine bucur bună ca care caut ce cel ceva chiar cinci cine cineva contra cu cum cumva curând curînd când cât câte câtva câţi cînd cît cîte cîtva cîţi că căci cărei căror cărui către da dacă dar datorită dată dau de deci deja deoarece departe deşi din dinaintea dintr- dintre doi doilea două drept după dă ea ei el ele eram este eu eşti face fata fi fie fiecare fii fim fiu fiţi frumos fără graţie halbă iar ieri la le li lor lui lângă lîngă mai mea mei mele mereu meu mi mie mine mult multă mulţi mulţumesc mâine mîine mă ne nevoie nici nicăieri nimeni nimeri nimic nişte noastre noastră noi noroc nostru nouă noştri nu opt ori oricare orice oricine oricum oricând oricât oricînd oricît oriunde patra patru patrulea pe pentru peste pic poate pot prea prima primul prin puţin puţina puţină până pînă rog sa sale sau se spate spre sub sunt suntem sunteţi sută sînt sîntem sînteţi să săi său ta tale te timp tine toate toată tot totuşi toţi trei treia treilea tu tăi tău un una unde undeva unei uneia unele uneori unii unor unora unu unui unuia unul vi voastre voastră voi vostru vouă voştri vreme vreo vreun vă zece zero zi zice îi îl îmi împotriva în înainte înaintea încotro încât încît între întrucât întrucît îţi ăla ălea ăsta ăstea ăştia şapte şase şi ştiu ţi ţie".split(" ")),e.Pipeline.registerFunction(e.ro.stopWordFilter,"stopWordFilter-ro")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.ru.min.js b/assets/javascripts/lunr/min/lunr.ru.min.js new file mode 100644 index 00000000..186cc485 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.ru.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Russian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,n){"function"==typeof define&&define.amd?define(n):"object"==typeof exports?module.exports=n():n()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ru=function(){this.pipeline.reset(),this.pipeline.add(e.ru.trimmer,e.ru.stopWordFilter,e.ru.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ru.stemmer))},e.ru.wordCharacters="Ѐ-҄҇-ԯᴫᵸⷠ-ⷿꙀ-ꚟ︮︯",e.ru.trimmer=e.trimmerSupport.generateTrimmer(e.ru.wordCharacters),e.Pipeline.registerFunction(e.ru.trimmer,"trimmer-ru"),e.ru.stemmer=function(){var n=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,t=new function(){function e(){for(;!W.in_grouping(S,1072,1103);){if(W.cursor>=W.limit)return!1;W.cursor++}return!0}function t(){for(;!W.out_grouping(S,1072,1103);){if(W.cursor>=W.limit)return!1;W.cursor++}return!0}function w(){b=W.limit,_=b,e()&&(b=W.cursor,t()&&e()&&t()&&(_=W.cursor))}function i(){return _<=W.cursor}function u(e,n){var r,t;if(W.ket=W.cursor,r=W.find_among_b(e,n)){switch(W.bra=W.cursor,r){case 1:if(t=W.limit-W.cursor,!W.eq_s_b(1,"а")&&(W.cursor=W.limit-t,!W.eq_s_b(1,"я")))return!1;case 2:W.slice_del()}return!0}return!1}function o(){return u(h,9)}function s(e,n){var r;return W.ket=W.cursor,!!(r=W.find_among_b(e,n))&&(W.bra=W.cursor,1==r&&W.slice_del(),!0)}function c(){return s(g,26)}function m(){return!!c()&&(u(C,8),!0)}function f(){return s(k,2)}function l(){return u(P,46)}function a(){s(v,36)}function p(){var e;W.ket=W.cursor,(e=W.find_among_b(F,2))&&(W.bra=W.cursor,i()&&1==e&&W.slice_del())}function d(){var e;if(W.ket=W.cursor,e=W.find_among_b(q,4))switch(W.bra=W.cursor,e){case 1:if(W.slice_del(),W.ket=W.cursor,!W.eq_s_b(1,"н"))break;W.bra=W.cursor;case 2:if(!W.eq_s_b(1,"н"))break;case 3:W.slice_del()}}var _,b,h=[new n("в",-1,1),new n("ив",0,2),new n("ыв",0,2),new n("вши",-1,1),new n("ивши",3,2),new n("ывши",3,2),new n("вшись",-1,1),new n("ившись",6,2),new n("ывшись",6,2)],g=[new n("ее",-1,1),new n("ие",-1,1),new n("ое",-1,1),new n("ые",-1,1),new n("ими",-1,1),new n("ыми",-1,1),new n("ей",-1,1),new n("ий",-1,1),new n("ой",-1,1),new n("ый",-1,1),new n("ем",-1,1),new n("им",-1,1),new n("ом",-1,1),new n("ым",-1,1),new n("его",-1,1),new n("ого",-1,1),new n("ему",-1,1),new n("ому",-1,1),new n("их",-1,1),new n("ых",-1,1),new n("ею",-1,1),new n("ою",-1,1),new n("ую",-1,1),new n("юю",-1,1),new n("ая",-1,1),new n("яя",-1,1)],C=[new n("ем",-1,1),new n("нн",-1,1),new n("вш",-1,1),new n("ивш",2,2),new n("ывш",2,2),new n("щ",-1,1),new n("ющ",5,1),new n("ующ",6,2)],k=[new n("сь",-1,1),new n("ся",-1,1)],P=[new n("ла",-1,1),new n("ила",0,2),new n("ыла",0,2),new n("на",-1,1),new n("ена",3,2),new n("ете",-1,1),new n("ите",-1,2),new n("йте",-1,1),new n("ейте",7,2),new n("уйте",7,2),new n("ли",-1,1),new n("или",10,2),new n("ыли",10,2),new n("й",-1,1),new n("ей",13,2),new n("уй",13,2),new n("л",-1,1),new n("ил",16,2),new n("ыл",16,2),new n("ем",-1,1),new n("им",-1,2),new n("ым",-1,2),new n("н",-1,1),new n("ен",22,2),new n("ло",-1,1),new n("ило",24,2),new n("ыло",24,2),new n("но",-1,1),new n("ено",27,2),new n("нно",27,1),new n("ет",-1,1),new n("ует",30,2),new n("ит",-1,2),new n("ыт",-1,2),new n("ют",-1,1),new n("уют",34,2),new n("ят",-1,2),new n("ны",-1,1),new n("ены",37,2),new n("ть",-1,1),new n("ить",39,2),new n("ыть",39,2),new n("ешь",-1,1),new n("ишь",-1,2),new n("ю",-1,2),new n("ую",44,2)],v=[new n("а",-1,1),new n("ев",-1,1),new n("ов",-1,1),new n("е",-1,1),new n("ие",3,1),new n("ье",3,1),new n("и",-1,1),new n("еи",6,1),new n("ии",6,1),new n("ами",6,1),new n("ями",6,1),new n("иями",10,1),new n("й",-1,1),new n("ей",12,1),new n("ией",13,1),new n("ий",12,1),new n("ой",12,1),new n("ам",-1,1),new n("ем",-1,1),new n("ием",18,1),new n("ом",-1,1),new n("ям",-1,1),new n("иям",21,1),new n("о",-1,1),new n("у",-1,1),new n("ах",-1,1),new n("ях",-1,1),new n("иях",26,1),new n("ы",-1,1),new n("ь",-1,1),new n("ю",-1,1),new n("ию",30,1),new n("ью",30,1),new n("я",-1,1),new n("ия",33,1),new n("ья",33,1)],F=[new n("ост",-1,1),new n("ость",-1,1)],q=[new n("ейше",-1,1),new n("н",-1,2),new n("ейш",-1,1),new n("ь",-1,3)],S=[33,65,8,232],W=new r;this.setCurrent=function(e){W.setCurrent(e)},this.getCurrent=function(){return W.getCurrent()},this.stem=function(){return w(),W.cursor=W.limit,!(W.cursor=i&&(e-=i,t[e>>3]&1<<(7&e)))return this.cursor++,!0}return!1},in_grouping_b:function(t,i,s){if(this.cursor>this.limit_backward){var e=r.charCodeAt(this.cursor-1);if(e<=s&&e>=i&&(e-=i,t[e>>3]&1<<(7&e)))return this.cursor--,!0}return!1},out_grouping:function(t,i,s){if(this.cursors||e>3]&1<<(7&e)))return this.cursor++,!0}return!1},out_grouping_b:function(t,i,s){if(this.cursor>this.limit_backward){var e=r.charCodeAt(this.cursor-1);if(e>s||e>3]&1<<(7&e)))return this.cursor--,!0}return!1},eq_s:function(t,i){if(this.limit-this.cursor>1),f=0,l=o0||e==s||c)break;c=!0}}for(;;){var _=t[s];if(o>=_.s_size){if(this.cursor=n+_.s_size,!_.method)return _.result;var b=_.method();if(this.cursor=n+_.s_size,b)return _.result}if((s=_.substring_i)<0)return 0}},find_among_b:function(t,i){for(var s=0,e=i,n=this.cursor,u=this.limit_backward,o=0,h=0,c=!1;;){for(var a=s+(e-s>>1),f=0,l=o=0;m--){if(n-l==u){f=-1;break}if(f=r.charCodeAt(n-1-l)-_.s[m])break;l++}if(f<0?(e=a,h=l):(s=a,o=l),e-s<=1){if(s>0||e==s||c)break;c=!0}}for(;;){var _=t[s];if(o>=_.s_size){if(this.cursor=n-_.s_size,!_.method)return _.result;var b=_.method();if(this.cursor=n-_.s_size,b)return _.result}if((s=_.substring_i)<0)return 0}},replace_s:function(t,i,s){var e=s.length-(i-t),n=r.substring(0,t),u=r.substring(i);return r=n+s+u,this.limit+=e,this.cursor>=i?this.cursor+=e:this.cursor>t&&(this.cursor=t),e},slice_check:function(){if(this.bra<0||this.bra>this.ket||this.ket>this.limit||this.limit>r.length)throw"faulty slice operation"},slice_from:function(r){this.slice_check(),this.replace_s(this.bra,this.ket,r)},slice_del:function(){this.slice_from("")},insert:function(r,t,i){var s=this.replace_s(r,t,i);r<=this.bra&&(this.bra+=s),r<=this.ket&&(this.ket+=s)},slice_to:function(){return this.slice_check(),r.substring(this.bra,this.ket)},eq_v_b:function(r){return this.eq_s_b(r.length,r)}}}},r.trimmerSupport={generateTrimmer:function(r){var t=new RegExp("^[^"+r+"]+"),i=new RegExp("[^"+r+"]+$");return function(r){return"function"==typeof r.update?r.update(function(r){return r.replace(t,"").replace(i,"")}):r.replace(t,"").replace(i,"")}}}}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.sv.min.js b/assets/javascripts/lunr/min/lunr.sv.min.js new file mode 100644 index 00000000..3e5eb640 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.sv.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Swedish` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.sv=function(){this.pipeline.reset(),this.pipeline.add(e.sv.trimmer,e.sv.stopWordFilter,e.sv.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.sv.stemmer))},e.sv.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.sv.trimmer=e.trimmerSupport.generateTrimmer(e.sv.wordCharacters),e.Pipeline.registerFunction(e.sv.trimmer,"trimmer-sv"),e.sv.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,t=new function(){function e(){var e,r=w.cursor+3;if(o=w.limit,0<=r||r<=w.limit){for(a=r;;){if(e=w.cursor,w.in_grouping(l,97,246)){w.cursor=e;break}if(w.cursor=e,w.cursor>=w.limit)return;w.cursor++}for(;!w.out_grouping(l,97,246);){if(w.cursor>=w.limit)return;w.cursor++}o=w.cursor,o=o&&(w.limit_backward=o,w.cursor=w.limit,w.ket=w.cursor,e=w.find_among_b(u,37),w.limit_backward=r,e))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:w.in_grouping_b(d,98,121)&&w.slice_del()}}function i(){var e=w.limit_backward;w.cursor>=o&&(w.limit_backward=o,w.cursor=w.limit,w.find_among_b(c,7)&&(w.cursor=w.limit,w.ket=w.cursor,w.cursor>w.limit_backward&&(w.bra=--w.cursor,w.slice_del())),w.limit_backward=e)}function s(){var e,r;if(w.cursor>=o){if(r=w.limit_backward,w.limit_backward=o,w.cursor=w.limit,w.ket=w.cursor,e=w.find_among_b(m,5))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:w.slice_from("lös");break;case 3:w.slice_from("full")}w.limit_backward=r}}var a,o,u=[new r("a",-1,1),new r("arna",0,1),new r("erna",0,1),new r("heterna",2,1),new r("orna",0,1),new r("ad",-1,1),new r("e",-1,1),new r("ade",6,1),new r("ande",6,1),new r("arne",6,1),new r("are",6,1),new r("aste",6,1),new r("en",-1,1),new r("anden",12,1),new r("aren",12,1),new r("heten",12,1),new r("ern",-1,1),new r("ar",-1,1),new r("er",-1,1),new r("heter",18,1),new r("or",-1,1),new r("s",-1,2),new r("as",21,1),new r("arnas",22,1),new r("ernas",22,1),new r("ornas",22,1),new r("es",21,1),new r("ades",26,1),new r("andes",26,1),new r("ens",21,1),new r("arens",29,1),new r("hetens",29,1),new r("erns",21,1),new r("at",-1,1),new r("andet",-1,1),new r("het",-1,1),new r("ast",-1,1)],c=[new r("dd",-1,-1),new r("gd",-1,-1),new r("nn",-1,-1),new r("dt",-1,-1),new r("gt",-1,-1),new r("kt",-1,-1),new r("tt",-1,-1)],m=[new r("ig",-1,1),new r("lig",0,1),new r("els",-1,1),new r("fullt",-1,3),new r("löst",-1,2)],l=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,24,0,32],d=[119,127,149],w=new n;this.setCurrent=function(e){w.setCurrent(e)},this.getCurrent=function(){return w.getCurrent()},this.stem=function(){var r=w.cursor;return e(),w.limit_backward=r,w.cursor=w.limit,t(),w.cursor=w.limit,i(),w.cursor=w.limit,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return t.setCurrent(e),t.stem(),t.getCurrent()}):(t.setCurrent(e),t.stem(),t.getCurrent())}}(),e.Pipeline.registerFunction(e.sv.stemmer,"stemmer-sv"),e.sv.stopWordFilter=e.generateStopWordFilter("alla allt att av blev bli blir blivit de dem den denna deras dess dessa det detta dig din dina ditt du där då efter ej eller en er era ert ett från för ha hade han hans har henne hennes hon honom hur här i icke ingen inom inte jag ju kan kunde man med mellan men mig min mina mitt mot mycket ni nu när någon något några och om oss på samma sedan sig sin sina sitta själv skulle som så sådan sådana sådant till under upp ut utan vad var vara varför varit varje vars vart vem vi vid vilka vilkas vilken vilket vår våra vårt än är åt över".split(" ")),e.Pipeline.registerFunction(e.sv.stopWordFilter,"stopWordFilter-sv")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.ta.min.js b/assets/javascripts/lunr/min/lunr.ta.min.js new file mode 100644 index 00000000..a644bed2 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.ta.min.js @@ -0,0 +1 @@ +!function(e,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ta=function(){this.pipeline.reset(),this.pipeline.add(e.ta.trimmer,e.ta.stopWordFilter,e.ta.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ta.stemmer))},e.ta.wordCharacters="஀-உஊ-ஏஐ-ஙச-ட஠-னப-யர-ஹ஺-ிீ-௉ொ-௏ௐ-௙௚-௟௠-௩௪-௯௰-௹௺-௿a-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.ta.trimmer=e.trimmerSupport.generateTrimmer(e.ta.wordCharacters),e.Pipeline.registerFunction(e.ta.trimmer,"trimmer-ta"),e.ta.stopWordFilter=e.generateStopWordFilter("அங்கு அங்கே அது அதை அந்த அவர் அவர்கள் அவள் அவன் அவை ஆக ஆகவே ஆகையால் ஆதலால் ஆதலினால் ஆனாலும் ஆனால் இங்கு இங்கே இது இதை இந்த இப்படி இவர் இவர்கள் இவள் இவன் இவை இவ்வளவு உனக்கு உனது உன் உன்னால் எங்கு எங்கே எது எதை எந்த எப்படி எவர் எவர்கள் எவள் எவன் எவை எவ்வளவு எனக்கு எனது எனவே என் என்ன என்னால் ஏது ஏன் தனது தன்னால் தானே தான் நாங்கள் நாம் நான் நீ நீங்கள்".split(" ")),e.ta.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var t=e.wordcut;t.init(),e.ta.tokenizer=function(r){if(!arguments.length||null==r||void 0==r)return[];if(Array.isArray(r))return r.map(function(t){return isLunr2?new e.Token(t.toLowerCase()):t.toLowerCase()});var i=r.toString().toLowerCase().replace(/^\s+/,"");return t.cut(i).split("|")},e.Pipeline.registerFunction(e.ta.stemmer,"stemmer-ta"),e.Pipeline.registerFunction(e.ta.stopWordFilter,"stopWordFilter-ta")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.te.min.js b/assets/javascripts/lunr/min/lunr.te.min.js new file mode 100644 index 00000000..9fa7a93b --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.te.min.js @@ -0,0 +1 @@ +!function(e,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.te=function(){this.pipeline.reset(),this.pipeline.add(e.te.trimmer,e.te.stopWordFilter,e.te.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.te.stemmer))},e.te.wordCharacters="ఀ-ఄఅ-ఔక-హా-ౌౕ-ౖౘ-ౚౠ-ౡౢ-ౣ౦-౯౸-౿఼ఽ్ౝ౷౤౥",e.te.trimmer=e.trimmerSupport.generateTrimmer(e.te.wordCharacters),e.Pipeline.registerFunction(e.te.trimmer,"trimmer-te"),e.te.stopWordFilter=e.generateStopWordFilter("అందరూ అందుబాటులో అడగండి అడగడం అడ్డంగా అనుగుణంగా అనుమతించు అనుమతిస్తుంది అయితే ఇప్పటికే ఉన్నారు ఎక్కడైనా ఎప్పుడు ఎవరైనా ఎవరో ఏ ఏదైనా ఏమైనప్పటికి ఒక ఒకరు కనిపిస్తాయి కాదు కూడా గా గురించి చుట్టూ చేయగలిగింది తగిన తర్వాత దాదాపు దూరంగా నిజంగా పై ప్రకారం ప్రక్కన మధ్య మరియు మరొక మళ్ళీ మాత్రమే మెచ్చుకో వద్ద వెంట వేరుగా వ్యతిరేకంగా సంబంధం".split(" ")),e.te.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var t=e.wordcut;t.init(),e.te.tokenizer=function(r){if(!arguments.length||null==r||void 0==r)return[];if(Array.isArray(r))return r.map(function(t){return isLunr2?new e.Token(t.toLowerCase()):t.toLowerCase()});var i=r.toString().toLowerCase().replace(/^\s+/,"");return t.cut(i).split("|")},e.Pipeline.registerFunction(e.te.stemmer,"stemmer-te"),e.Pipeline.registerFunction(e.te.stopWordFilter,"stopWordFilter-te")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.th.min.js b/assets/javascripts/lunr/min/lunr.th.min.js new file mode 100644 index 00000000..dee3aac6 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.th.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var r="2"==e.version[0];e.th=function(){this.pipeline.reset(),this.pipeline.add(e.th.trimmer),r?this.tokenizer=e.th.tokenizer:(e.tokenizer&&(e.tokenizer=e.th.tokenizer),this.tokenizerFn&&(this.tokenizerFn=e.th.tokenizer))},e.th.wordCharacters="[฀-๿]",e.th.trimmer=e.trimmerSupport.generateTrimmer(e.th.wordCharacters),e.Pipeline.registerFunction(e.th.trimmer,"trimmer-th");var t=e.wordcut;t.init(),e.th.tokenizer=function(i){if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(t){return r?new e.Token(t):t});var n=i.toString().replace(/^\s+/,"");return t.cut(n).split("|")}}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.tr.min.js b/assets/javascripts/lunr/min/lunr.tr.min.js new file mode 100644 index 00000000..563f6ec1 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.tr.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Turkish` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(r,i){"function"==typeof define&&define.amd?define(i):"object"==typeof exports?module.exports=i():i()(r.lunr)}(this,function(){return function(r){if(void 0===r)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===r.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");r.tr=function(){this.pipeline.reset(),this.pipeline.add(r.tr.trimmer,r.tr.stopWordFilter,r.tr.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(r.tr.stemmer))},r.tr.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",r.tr.trimmer=r.trimmerSupport.generateTrimmer(r.tr.wordCharacters),r.Pipeline.registerFunction(r.tr.trimmer,"trimmer-tr"),r.tr.stemmer=function(){var i=r.stemmerSupport.Among,e=r.stemmerSupport.SnowballProgram,n=new function(){function r(r,i,e){for(;;){var n=Dr.limit-Dr.cursor;if(Dr.in_grouping_b(r,i,e)){Dr.cursor=Dr.limit-n;break}if(Dr.cursor=Dr.limit-n,Dr.cursor<=Dr.limit_backward)return!1;Dr.cursor--}return!0}function n(){var i,e;i=Dr.limit-Dr.cursor,r(Wr,97,305);for(var n=0;nDr.limit_backward&&(Dr.cursor--,e=Dr.limit-Dr.cursor,i()))?(Dr.cursor=Dr.limit-e,!0):(Dr.cursor=Dr.limit-n,r()?(Dr.cursor=Dr.limit-n,!1):(Dr.cursor=Dr.limit-n,!(Dr.cursor<=Dr.limit_backward)&&(Dr.cursor--,!!i()&&(Dr.cursor=Dr.limit-n,!0))))}function u(r){return t(r,function(){return Dr.in_grouping_b(Wr,97,305)})}function o(){return u(function(){return Dr.eq_s_b(1,"n")})}function s(){return u(function(){return Dr.eq_s_b(1,"s")})}function c(){return u(function(){return Dr.eq_s_b(1,"y")})}function l(){return t(function(){return Dr.in_grouping_b(Lr,105,305)},function(){return Dr.out_grouping_b(Wr,97,305)})}function a(){return Dr.find_among_b(ur,10)&&l()}function m(){return n()&&Dr.in_grouping_b(Lr,105,305)&&s()}function d(){return Dr.find_among_b(or,2)}function f(){return n()&&Dr.in_grouping_b(Lr,105,305)&&c()}function b(){return n()&&Dr.find_among_b(sr,4)}function w(){return n()&&Dr.find_among_b(cr,4)&&o()}function _(){return n()&&Dr.find_among_b(lr,2)&&c()}function k(){return n()&&Dr.find_among_b(ar,2)}function p(){return n()&&Dr.find_among_b(mr,4)}function g(){return n()&&Dr.find_among_b(dr,2)}function y(){return n()&&Dr.find_among_b(fr,4)}function z(){return n()&&Dr.find_among_b(br,2)}function v(){return n()&&Dr.find_among_b(wr,2)&&c()}function h(){return Dr.eq_s_b(2,"ki")}function q(){return n()&&Dr.find_among_b(_r,2)&&o()}function C(){return n()&&Dr.find_among_b(kr,4)&&c()}function P(){return n()&&Dr.find_among_b(pr,4)}function F(){return n()&&Dr.find_among_b(gr,4)&&c()}function S(){return Dr.find_among_b(yr,4)}function W(){return n()&&Dr.find_among_b(zr,2)}function L(){return n()&&Dr.find_among_b(vr,4)}function x(){return n()&&Dr.find_among_b(hr,8)}function A(){return Dr.find_among_b(qr,2)}function E(){return n()&&Dr.find_among_b(Cr,32)&&c()}function j(){return Dr.find_among_b(Pr,8)&&c()}function T(){return n()&&Dr.find_among_b(Fr,4)&&c()}function Z(){return Dr.eq_s_b(3,"ken")&&c()}function B(){var r=Dr.limit-Dr.cursor;return!(T()||(Dr.cursor=Dr.limit-r,E()||(Dr.cursor=Dr.limit-r,j()||(Dr.cursor=Dr.limit-r,Z()))))}function D(){if(A()){var r=Dr.limit-Dr.cursor;if(S()||(Dr.cursor=Dr.limit-r,W()||(Dr.cursor=Dr.limit-r,C()||(Dr.cursor=Dr.limit-r,P()||(Dr.cursor=Dr.limit-r,F()||(Dr.cursor=Dr.limit-r))))),T())return!1}return!0}function G(){if(W()){Dr.bra=Dr.cursor,Dr.slice_del();var r=Dr.limit-Dr.cursor;return Dr.ket=Dr.cursor,x()||(Dr.cursor=Dr.limit-r,E()||(Dr.cursor=Dr.limit-r,j()||(Dr.cursor=Dr.limit-r,T()||(Dr.cursor=Dr.limit-r)))),nr=!1,!1}return!0}function H(){if(!L())return!0;var r=Dr.limit-Dr.cursor;return!E()&&(Dr.cursor=Dr.limit-r,!j())}function I(){var r,i=Dr.limit-Dr.cursor;return!(S()||(Dr.cursor=Dr.limit-i,F()||(Dr.cursor=Dr.limit-i,P()||(Dr.cursor=Dr.limit-i,C()))))||(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,T()||(Dr.cursor=Dr.limit-r),!1)}function J(){var r,i=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,nr=!0,B()&&(Dr.cursor=Dr.limit-i,D()&&(Dr.cursor=Dr.limit-i,G()&&(Dr.cursor=Dr.limit-i,H()&&(Dr.cursor=Dr.limit-i,I()))))){if(Dr.cursor=Dr.limit-i,!x())return;Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,r=Dr.limit-Dr.cursor,S()||(Dr.cursor=Dr.limit-r,W()||(Dr.cursor=Dr.limit-r,C()||(Dr.cursor=Dr.limit-r,P()||(Dr.cursor=Dr.limit-r,F()||(Dr.cursor=Dr.limit-r))))),T()||(Dr.cursor=Dr.limit-r)}Dr.bra=Dr.cursor,Dr.slice_del()}function K(){var r,i,e,n;if(Dr.ket=Dr.cursor,h()){if(r=Dr.limit-Dr.cursor,p())return Dr.bra=Dr.cursor,Dr.slice_del(),i=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,W()?(Dr.bra=Dr.cursor,Dr.slice_del(),K()):(Dr.cursor=Dr.limit-i,a()&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()))),!0;if(Dr.cursor=Dr.limit-r,w()){if(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,e=Dr.limit-Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else{if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,!a()&&(Dr.cursor=Dr.limit-e,!m()&&(Dr.cursor=Dr.limit-e,!K())))return!0;Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())}return!0}if(Dr.cursor=Dr.limit-r,g()){if(n=Dr.limit-Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else if(Dr.cursor=Dr.limit-n,m())Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K());else if(Dr.cursor=Dr.limit-n,!K())return!1;return!0}}return!1}function M(r){if(Dr.ket=Dr.cursor,!g()&&(Dr.cursor=Dr.limit-r,!k()))return!1;var i=Dr.limit-Dr.cursor;if(d())Dr.bra=Dr.cursor,Dr.slice_del();else if(Dr.cursor=Dr.limit-i,m())Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K());else if(Dr.cursor=Dr.limit-i,!K())return!1;return!0}function N(r){if(Dr.ket=Dr.cursor,!z()&&(Dr.cursor=Dr.limit-r,!b()))return!1;var i=Dr.limit-Dr.cursor;return!(!m()&&(Dr.cursor=Dr.limit-i,!d()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()),!0)}function O(){var r,i=Dr.limit-Dr.cursor;return Dr.ket=Dr.cursor,!(!w()&&(Dr.cursor=Dr.limit-i,!v()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,!(!W()||(Dr.bra=Dr.cursor,Dr.slice_del(),!K()))||(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!(a()||(Dr.cursor=Dr.limit-r,m()||(Dr.cursor=Dr.limit-r,K())))||(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()),!0)))}function Q(){var r,i,e=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,!p()&&(Dr.cursor=Dr.limit-e,!f()&&(Dr.cursor=Dr.limit-e,!_())))return!1;if(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,r=Dr.limit-Dr.cursor,a())Dr.bra=Dr.cursor,Dr.slice_del(),i=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,W()||(Dr.cursor=Dr.limit-i);else if(Dr.cursor=Dr.limit-r,!W())return!0;return Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,K(),!0}function R(){var r,i,e=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,W())return Dr.bra=Dr.cursor,Dr.slice_del(),void K();if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,q())if(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else{if(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!a()&&(Dr.cursor=Dr.limit-r,!m())){if(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!W())return;if(Dr.bra=Dr.cursor,Dr.slice_del(),!K())return}Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())}else if(Dr.cursor=Dr.limit-e,!M(e)&&(Dr.cursor=Dr.limit-e,!N(e))){if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,y())return Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,i=Dr.limit-Dr.cursor,void(a()?(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())):(Dr.cursor=Dr.limit-i,W()?(Dr.bra=Dr.cursor,Dr.slice_del(),K()):(Dr.cursor=Dr.limit-i,K())));if(Dr.cursor=Dr.limit-e,!O()){if(Dr.cursor=Dr.limit-e,d())return Dr.bra=Dr.cursor,void Dr.slice_del();Dr.cursor=Dr.limit-e,K()||(Dr.cursor=Dr.limit-e,Q()||(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,(a()||(Dr.cursor=Dr.limit-e,m()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()))))}}}function U(){var r;if(Dr.ket=Dr.cursor,r=Dr.find_among_b(Sr,4))switch(Dr.bra=Dr.cursor,r){case 1:Dr.slice_from("p");break;case 2:Dr.slice_from("ç");break;case 3:Dr.slice_from("t");break;case 4:Dr.slice_from("k")}}function V(){for(;;){var r=Dr.limit-Dr.cursor;if(Dr.in_grouping_b(Wr,97,305)){Dr.cursor=Dr.limit-r;break}if(Dr.cursor=Dr.limit-r,Dr.cursor<=Dr.limit_backward)return!1;Dr.cursor--}return!0}function X(r,i,e){if(Dr.cursor=Dr.limit-r,V()){var n=Dr.limit-Dr.cursor;if(!Dr.eq_s_b(1,i)&&(Dr.cursor=Dr.limit-n,!Dr.eq_s_b(1,e)))return!0;Dr.cursor=Dr.limit-r;var t=Dr.cursor;return Dr.insert(Dr.cursor,Dr.cursor,e),Dr.cursor=t,!1}return!0}function Y(){var r=Dr.limit-Dr.cursor;(Dr.eq_s_b(1,"d")||(Dr.cursor=Dr.limit-r,Dr.eq_s_b(1,"g")))&&X(r,"a","ı")&&X(r,"e","i")&&X(r,"o","u")&&X(r,"ö","ü")}function $(){for(var r,i=Dr.cursor,e=2;;){for(r=Dr.cursor;!Dr.in_grouping(Wr,97,305);){if(Dr.cursor>=Dr.limit)return Dr.cursor=r,!(e>0)&&(Dr.cursor=i,!0);Dr.cursor++}e--}}function rr(r,i,e){for(;!Dr.eq_s(i,e);){if(Dr.cursor>=Dr.limit)return!0;Dr.cursor++}return(tr=i)!=Dr.limit||(Dr.cursor=r,!1)}function ir(){var r=Dr.cursor;return!rr(r,2,"ad")||(Dr.cursor=r,!rr(r,5,"soyad"))}function er(){var r=Dr.cursor;return!ir()&&(Dr.limit_backward=r,Dr.cursor=Dr.limit,Y(),Dr.cursor=Dr.limit,U(),!0)}var nr,tr,ur=[new i("m",-1,-1),new i("n",-1,-1),new i("miz",-1,-1),new i("niz",-1,-1),new i("muz",-1,-1),new i("nuz",-1,-1),new i("müz",-1,-1),new i("nüz",-1,-1),new i("mız",-1,-1),new i("nız",-1,-1)],or=[new i("leri",-1,-1),new i("ları",-1,-1)],sr=[new i("ni",-1,-1),new i("nu",-1,-1),new i("nü",-1,-1),new i("nı",-1,-1)],cr=[new i("in",-1,-1),new i("un",-1,-1),new i("ün",-1,-1),new i("ın",-1,-1)],lr=[new i("a",-1,-1),new i("e",-1,-1)],ar=[new i("na",-1,-1),new i("ne",-1,-1)],mr=[new i("da",-1,-1),new i("ta",-1,-1),new i("de",-1,-1),new i("te",-1,-1)],dr=[new i("nda",-1,-1),new i("nde",-1,-1)],fr=[new i("dan",-1,-1),new i("tan",-1,-1),new i("den",-1,-1),new i("ten",-1,-1)],br=[new i("ndan",-1,-1),new i("nden",-1,-1)],wr=[new i("la",-1,-1),new i("le",-1,-1)],_r=[new i("ca",-1,-1),new i("ce",-1,-1)],kr=[new i("im",-1,-1),new i("um",-1,-1),new i("üm",-1,-1),new i("ım",-1,-1)],pr=[new i("sin",-1,-1),new i("sun",-1,-1),new i("sün",-1,-1),new i("sın",-1,-1)],gr=[new i("iz",-1,-1),new i("uz",-1,-1),new i("üz",-1,-1),new i("ız",-1,-1)],yr=[new i("siniz",-1,-1),new i("sunuz",-1,-1),new i("sünüz",-1,-1),new i("sınız",-1,-1)],zr=[new i("lar",-1,-1),new i("ler",-1,-1)],vr=[new i("niz",-1,-1),new i("nuz",-1,-1),new i("nüz",-1,-1),new i("nız",-1,-1)],hr=[new i("dir",-1,-1),new i("tir",-1,-1),new i("dur",-1,-1),new i("tur",-1,-1),new i("dür",-1,-1),new i("tür",-1,-1),new i("dır",-1,-1),new i("tır",-1,-1)],qr=[new i("casına",-1,-1),new i("cesine",-1,-1)],Cr=[new i("di",-1,-1),new i("ti",-1,-1),new i("dik",-1,-1),new i("tik",-1,-1),new i("duk",-1,-1),new i("tuk",-1,-1),new i("dük",-1,-1),new i("tük",-1,-1),new i("dık",-1,-1),new i("tık",-1,-1),new i("dim",-1,-1),new i("tim",-1,-1),new i("dum",-1,-1),new i("tum",-1,-1),new i("düm",-1,-1),new i("tüm",-1,-1),new i("dım",-1,-1),new i("tım",-1,-1),new i("din",-1,-1),new i("tin",-1,-1),new i("dun",-1,-1),new i("tun",-1,-1),new i("dün",-1,-1),new i("tün",-1,-1),new i("dın",-1,-1),new i("tın",-1,-1),new i("du",-1,-1),new i("tu",-1,-1),new i("dü",-1,-1),new i("tü",-1,-1),new i("dı",-1,-1),new i("tı",-1,-1)],Pr=[new i("sa",-1,-1),new i("se",-1,-1),new i("sak",-1,-1),new i("sek",-1,-1),new i("sam",-1,-1),new i("sem",-1,-1),new i("san",-1,-1),new i("sen",-1,-1)],Fr=[new i("miş",-1,-1),new i("muş",-1,-1),new i("müş",-1,-1),new i("mış",-1,-1)],Sr=[new i("b",-1,1),new i("c",-1,2),new i("d",-1,3),new i("ğ",-1,4)],Wr=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,32,8,0,0,0,0,0,0,1],Lr=[1,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,0,0,0,0,0,1],xr=[1,64,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1],Ar=[17,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,130],Er=[1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1],jr=[17],Tr=[65],Zr=[65],Br=[["a",xr,97,305],["e",Ar,101,252],["ı",Er,97,305],["i",jr,101,105],["o",Tr,111,117],["ö",Zr,246,252],["u",Tr,111,117]],Dr=new e;this.setCurrent=function(r){Dr.setCurrent(r)},this.getCurrent=function(){return Dr.getCurrent()},this.stem=function(){return!!($()&&(Dr.limit_backward=Dr.cursor,Dr.cursor=Dr.limit,J(),Dr.cursor=Dr.limit,nr&&(R(),Dr.cursor=Dr.limit_backward,er())))}};return function(r){return"function"==typeof r.update?r.update(function(r){return n.setCurrent(r),n.stem(),n.getCurrent()}):(n.setCurrent(r),n.stem(),n.getCurrent())}}(),r.Pipeline.registerFunction(r.tr.stemmer,"stemmer-tr"),r.tr.stopWordFilter=r.generateStopWordFilter("acaba altmış altı ama ancak arada aslında ayrıca bana bazı belki ben benden beni benim beri beş bile bin bir biri birkaç birkez birçok birşey birşeyi biz bizden bize bizi bizim bu buna bunda bundan bunlar bunları bunların bunu bunun burada böyle böylece da daha dahi de defa değil diye diğer doksan dokuz dolayı dolayısıyla dört edecek eden ederek edilecek ediliyor edilmesi ediyor elli en etmesi etti ettiği ettiğini eğer gibi göre halen hangi hatta hem henüz hep hepsi her herhangi herkesin hiç hiçbir iki ile ilgili ise itibaren itibariyle için işte kadar karşın katrilyon kendi kendilerine kendini kendisi kendisine kendisini kez ki kim kimden kime kimi kimse kırk milyar milyon mu mü mı nasıl ne neden nedenle nerde nerede nereye niye niçin o olan olarak oldu olduklarını olduğu olduğunu olmadı olmadığı olmak olması olmayan olmaz olsa olsun olup olur olursa oluyor on ona ondan onlar onlardan onları onların onu onun otuz oysa pek rağmen sadece sanki sekiz seksen sen senden seni senin siz sizden sizi sizin tarafından trilyon tüm var vardı ve veya ya yani yapacak yapmak yaptı yaptıkları yaptığı yaptığını yapılan yapılması yapıyor yedi yerine yetmiş yine yirmi yoksa yüz zaten çok çünkü öyle üzere üç şey şeyden şeyi şeyler şu şuna şunda şundan şunları şunu şöyle".split(" ")),r.Pipeline.registerFunction(r.tr.stopWordFilter,"stopWordFilter-tr")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.vi.min.js b/assets/javascripts/lunr/min/lunr.vi.min.js new file mode 100644 index 00000000..22aed28c --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.vi.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.vi=function(){this.pipeline.reset(),this.pipeline.add(e.vi.stopWordFilter,e.vi.trimmer)},e.vi.wordCharacters="[A-Za-ẓ̀͐́͑̉̃̓ÂâÊêÔôĂ-ăĐ-đƠ-ơƯ-ư]",e.vi.trimmer=e.trimmerSupport.generateTrimmer(e.vi.wordCharacters),e.Pipeline.registerFunction(e.vi.trimmer,"trimmer-vi"),e.vi.stopWordFilter=e.generateStopWordFilter("là cái nhưng mà".split(" "))}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.zh.min.js b/assets/javascripts/lunr/min/lunr.zh.min.js new file mode 100644 index 00000000..fda66e9c --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.zh.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r(require("@node-rs/jieba")):r()(e.lunr)}(this,function(e){return function(r,t){if(void 0===r)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===r.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var i="2"==r.version[0];r.zh=function(){this.pipeline.reset(),this.pipeline.add(r.zh.trimmer,r.zh.stopWordFilter,r.zh.stemmer),i?this.tokenizer=r.zh.tokenizer:(r.tokenizer&&(r.tokenizer=r.zh.tokenizer),this.tokenizerFn&&(this.tokenizerFn=r.zh.tokenizer))},r.zh.tokenizer=function(n){if(!arguments.length||null==n||void 0==n)return[];if(Array.isArray(n))return n.map(function(e){return i?new r.Token(e.toLowerCase()):e.toLowerCase()});t&&e.load(t);var o=n.toString().trim().toLowerCase(),s=[];e.cut(o,!0).forEach(function(e){s=s.concat(e.split(" "))}),s=s.filter(function(e){return!!e});var u=0;return s.map(function(e,t){if(i){var n=o.indexOf(e,u),s={};return s.position=[n,e.length],s.index=t,u=n,new r.Token(e,s)}return e})},r.zh.wordCharacters="\\w一-龥",r.zh.trimmer=r.trimmerSupport.generateTrimmer(r.zh.wordCharacters),r.Pipeline.registerFunction(r.zh.trimmer,"trimmer-zh"),r.zh.stemmer=function(){return function(e){return e}}(),r.Pipeline.registerFunction(r.zh.stemmer,"stemmer-zh"),r.zh.stopWordFilter=r.generateStopWordFilter("的 一 不 在 人 有 是 为 為 以 于 於 上 他 而 后 後 之 来 來 及 了 因 下 可 到 由 这 這 与 與 也 此 但 并 並 个 個 其 已 无 無 小 我 们 們 起 最 再 今 去 好 只 又 或 很 亦 某 把 那 你 乃 它 吧 被 比 别 趁 当 當 从 從 得 打 凡 儿 兒 尔 爾 该 該 各 给 給 跟 和 何 还 還 即 几 幾 既 看 据 據 距 靠 啦 另 么 麽 每 嘛 拿 哪 您 凭 憑 且 却 卻 让 讓 仍 啥 如 若 使 谁 誰 虽 雖 随 隨 同 所 她 哇 嗡 往 些 向 沿 哟 喲 用 咱 则 則 怎 曾 至 致 着 著 诸 諸 自".split(" ")),r.Pipeline.registerFunction(r.zh.stopWordFilter,"stopWordFilter-zh")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/tinyseg.js b/assets/javascripts/lunr/tinyseg.js new file mode 100644 index 00000000..167fa6dd --- /dev/null +++ b/assets/javascripts/lunr/tinyseg.js @@ -0,0 +1,206 @@ +/** + * export the module via AMD, CommonJS or as a browser global + * Export code from https://github.com/umdjs/umd/blob/master/returnExports.js + */ +;(function (root, factory) { + if (typeof define === 'function' && define.amd) { + // AMD. Register as an anonymous module. + define(factory) + } else if (typeof exports === 'object') { + /** + * Node. Does not work with strict CommonJS, but + * only CommonJS-like environments that support module.exports, + * like Node. + */ + module.exports = factory() + } else { + // Browser globals (root is window) + factory()(root.lunr); + } +}(this, function () { + /** + * Just return a value to define the module export. + * This example returns an object, but the module + * can return a function as the exported value. + */ + + return function(lunr) { + // TinySegmenter 0.1 -- Super compact Japanese tokenizer in Javascript + // (c) 2008 Taku Kudo + // TinySegmenter is freely distributable under the terms of a new BSD licence. + // For details, see http://chasen.org/~taku/software/TinySegmenter/LICENCE.txt + + function TinySegmenter() { + var patterns = { + "[一二三四五六七八九十百千万億兆]":"M", + "[一-龠々〆ヵヶ]":"H", + "[ぁ-ん]":"I", + "[ァ-ヴーｱ-ﾝﾞｰ]":"K", + "[a-zA-Zａ-ｚＡ-Ｚ]":"A", + "[0-9０-９]":"N" + } + this.chartype_ = []; + for (var i in patterns) { + var regexp = new RegExp(i); + this.chartype_.push([regexp, patterns[i]]); + } + + this.BIAS__ = -332 + this.BC1__ = {"HH":6,"II":2461,"KH":406,"OH":-1378}; + this.BC2__ = {"AA":-3267,"AI":2744,"AN":-878,"HH":-4070,"HM":-1711,"HN":4012,"HO":3761,"IA":1327,"IH":-1184,"II":-1332,"IK":1721,"IO":5492,"KI":3831,"KK":-8741,"MH":-3132,"MK":3334,"OO":-2920}; + this.BC3__ = {"HH":996,"HI":626,"HK":-721,"HN":-1307,"HO":-836,"IH":-301,"KK":2762,"MK":1079,"MM":4034,"OA":-1652,"OH":266}; + this.BP1__ = {"BB":295,"OB":304,"OO":-125,"UB":352}; + this.BP2__ = {"BO":60,"OO":-1762}; + this.BQ1__ = {"BHH":1150,"BHM":1521,"BII":-1158,"BIM":886,"BMH":1208,"BNH":449,"BOH":-91,"BOO":-2597,"OHI":451,"OIH":-296,"OKA":1851,"OKH":-1020,"OKK":904,"OOO":2965}; + this.BQ2__ = {"BHH":118,"BHI":-1159,"BHM":466,"BIH":-919,"BKK":-1720,"BKO":864,"OHH":-1139,"OHM":-181,"OIH":153,"UHI":-1146}; + this.BQ3__ = {"BHH":-792,"BHI":2664,"BII":-299,"BKI":419,"BMH":937,"BMM":8335,"BNN":998,"BOH":775,"OHH":2174,"OHM":439,"OII":280,"OKH":1798,"OKI":-793,"OKO":-2242,"OMH":-2402,"OOO":11699}; + this.BQ4__ = {"BHH":-3895,"BIH":3761,"BII":-4654,"BIK":1348,"BKK":-1806,"BMI":-3385,"BOO":-12396,"OAH":926,"OHH":266,"OHK":-2036,"ONN":-973}; + this.BW1__ = {",と":660,",同":727,"B1あ":1404,"B1同":542,"、と":660,"、同":727,"」と":1682,"あっ":1505,"いう":1743,"いっ":-2055,"いる":672,"うし":-4817,"うん":665,"から":3472,"がら":600,"こう":-790,"こと":2083,"こん":-1262,"さら":-4143,"さん":4573,"した":2641,"して":1104,"すで":-3399,"そこ":1977,"それ":-871,"たち":1122,"ため":601,"った":3463,"つい":-802,"てい":805,"てき":1249,"でき":1127,"です":3445,"では":844,"とい":-4915,"とみ":1922,"どこ":3887,"ない":5713,"なっ":3015,"など":7379,"なん":-1113,"にし":2468,"には":1498,"にも":1671,"に対":-912,"の一":-501,"の中":741,"ませ":2448,"まで":1711,"まま":2600,"まる":-2155,"やむ":-1947,"よっ":-2565,"れた":2369,"れで":-913,"をし":1860,"を見":731,"亡く":-1886,"京都":2558,"取り":-2784,"大き":-2604,"大阪":1497,"平方":-2314,"引き":-1336,"日本":-195,"本当":-2423,"毎日":-2113,"目指":-724,"Ｂ１あ":1404,"Ｂ１同":542,"｣と":1682}; + this.BW2__ = {"..":-11822,"11":-669,"――":-5730,"−−":-13175,"いう":-1609,"うか":2490,"かし":-1350,"かも":-602,"から":-7194,"かれ":4612,"がい":853,"がら":-3198,"きた":1941,"くな":-1597,"こと":-8392,"この":-4193,"させ":4533,"され":13168,"さん":-3977,"しい":-1819,"しか":-545,"した":5078,"して":972,"しな":939,"その":-3744,"たい":-1253,"たた":-662,"ただ":-3857,"たち":-786,"たと":1224,"たは":-939,"った":4589,"って":1647,"っと":-2094,"てい":6144,"てき":3640,"てく":2551,"ては":-3110,"ても":-3065,"でい":2666,"でき":-1528,"でし":-3828,"です":-4761,"でも":-4203,"とい":1890,"とこ":-1746,"とと":-2279,"との":720,"とみ":5168,"とも":-3941,"ない":-2488,"なが":-1313,"など":-6509,"なの":2614,"なん":3099,"にお":-1615,"にし":2748,"にな":2454,"によ":-7236,"に対":-14943,"に従":-4688,"に関":-11388,"のか":2093,"ので":-7059,"のに":-6041,"のの":-6125,"はい":1073,"はが":-1033,"はず":-2532,"ばれ":1813,"まし":-1316,"まで":-6621,"まれ":5409,"めて":-3153,"もい":2230,"もの":-10713,"らか":-944,"らし":-1611,"らに":-1897,"りし":651,"りま":1620,"れた":4270,"れて":849,"れば":4114,"ろう":6067,"われ":7901,"を通":-11877,"んだ":728,"んな":-4115,"一人":602,"一方":-1375,"一日":970,"一部":-1051,"上が":-4479,"会社":-1116,"出て":2163,"分の":-7758,"同党":970,"同日":-913,"大阪":-2471,"委員":-1250,"少な":-1050,"年度":-8669,"年間":-1626,"府県":-2363,"手権":-1982,"新聞":-4066,"日新":-722,"日本":-7068,"日米":3372,"曜日":-601,"朝鮮":-2355,"本人":-2697,"東京":-1543,"然と":-1384,"社会":-1276,"立て":-990,"第に":-1612,"米国":-4268,"１１":-669}; + this.BW3__ = {"あた":-2194,"あり":719,"ある":3846,"い.":-1185,"い。":-1185,"いい":5308,"いえ":2079,"いく":3029,"いた":2056,"いっ":1883,"いる":5600,"いわ":1527,"うち":1117,"うと":4798,"えと":1454,"か.":2857,"か。":2857,"かけ":-743,"かっ":-4098,"かに":-669,"から":6520,"かり":-2670,"が,":1816,"が、":1816,"がき":-4855,"がけ":-1127,"がっ":-913,"がら":-4977,"がり":-2064,"きた":1645,"けど":1374,"こと":7397,"この":1542,"ころ":-2757,"さい":-714,"さを":976,"し,":1557,"し、":1557,"しい":-3714,"した":3562,"して":1449,"しな":2608,"しま":1200,"す.":-1310,"す。":-1310,"する":6521,"ず,":3426,"ず、":3426,"ずに":841,"そう":428,"た.":8875,"た。":8875,"たい":-594,"たの":812,"たり":-1183,"たる":-853,"だ.":4098,"だ。":4098,"だっ":1004,"った":-4748,"って":300,"てい":6240,"てお":855,"ても":302,"です":1437,"でに":-1482,"では":2295,"とう":-1387,"とし":2266,"との":541,"とも":-3543,"どう":4664,"ない":1796,"なく":-903,"など":2135,"に,":-1021,"に、":-1021,"にし":1771,"にな":1906,"には":2644,"の,":-724,"の、":-724,"の子":-1000,"は,":1337,"は、":1337,"べき":2181,"まし":1113,"ます":6943,"まっ":-1549,"まで":6154,"まれ":-793,"らし":1479,"られ":6820,"るる":3818,"れ,":854,"れ、":854,"れた":1850,"れて":1375,"れば":-3246,"れる":1091,"われ":-605,"んだ":606,"んで":798,"カ月":990,"会議":860,"入り":1232,"大会":2217,"始め":1681,"市":965,"新聞":-5055,"日,":974,"日、":974,"社会":2024,"ｶ月":990}; + this.TC1__ = {"AAA":1093,"HHH":1029,"HHM":580,"HII":998,"HOH":-390,"HOM":-331,"IHI":1169,"IOH":-142,"IOI":-1015,"IOM":467,"MMH":187,"OOI":-1832}; + this.TC2__ = {"HHO":2088,"HII":-1023,"HMM":-1154,"IHI":-1965,"KKH":703,"OII":-2649}; + this.TC3__ = {"AAA":-294,"HHH":346,"HHI":-341,"HII":-1088,"HIK":731,"HOH":-1486,"IHH":128,"IHI":-3041,"IHO":-1935,"IIH":-825,"IIM":-1035,"IOI":-542,"KHH":-1216,"KKA":491,"KKH":-1217,"KOK":-1009,"MHH":-2694,"MHM":-457,"MHO":123,"MMH":-471,"NNH":-1689,"NNO":662,"OHO":-3393}; + this.TC4__ = {"HHH":-203,"HHI":1344,"HHK":365,"HHM":-122,"HHN":182,"HHO":669,"HIH":804,"HII":679,"HOH":446,"IHH":695,"IHO":-2324,"IIH":321,"III":1497,"IIO":656,"IOO":54,"KAK":4845,"KKA":3386,"KKK":3065,"MHH":-405,"MHI":201,"MMH":-241,"MMM":661,"MOM":841}; + this.TQ1__ = {"BHHH":-227,"BHHI":316,"BHIH":-132,"BIHH":60,"BIII":1595,"BNHH":-744,"BOHH":225,"BOOO":-908,"OAKK":482,"OHHH":281,"OHIH":249,"OIHI":200,"OIIH":-68}; + this.TQ2__ = {"BIHH":-1401,"BIII":-1033,"BKAK":-543,"BOOO":-5591}; + this.TQ3__ = {"BHHH":478,"BHHM":-1073,"BHIH":222,"BHII":-504,"BIIH":-116,"BIII":-105,"BMHI":-863,"BMHM":-464,"BOMH":620,"OHHH":346,"OHHI":1729,"OHII":997,"OHMH":481,"OIHH":623,"OIIH":1344,"OKAK":2792,"OKHH":587,"OKKA":679,"OOHH":110,"OOII":-685}; + this.TQ4__ = {"BHHH":-721,"BHHM":-3604,"BHII":-966,"BIIH":-607,"BIII":-2181,"OAAA":-2763,"OAKK":180,"OHHH":-294,"OHHI":2446,"OHHO":480,"OHIH":-1573,"OIHH":1935,"OIHI":-493,"OIIH":626,"OIII":-4007,"OKAK":-8156}; + this.TW1__ = {"につい":-4681,"東京都":2026}; + this.TW2__ = {"ある程":-2049,"いった":-1256,"ころが":-2434,"しょう":3873,"その後":-4430,"だって":-1049,"ていた":1833,"として":-4657,"ともに":-4517,"もので":1882,"一気に":-792,"初めて":-1512,"同時に":-8097,"大きな":-1255,"対して":-2721,"社会党":-3216}; + this.TW3__ = {"いただ":-1734,"してい":1314,"として":-4314,"につい":-5483,"にとっ":-5989,"に当た":-6247,"ので,":-727,"ので、":-727,"のもの":-600,"れから":-3752,"十二月":-2287}; + this.TW4__ = {"いう.":8576,"いう。":8576,"からな":-2348,"してい":2958,"たが,":1516,"たが、":1516,"ている":1538,"という":1349,"ました":5543,"ません":1097,"ようと":-4258,"よると":5865}; + this.UC1__ = {"A":484,"K":93,"M":645,"O":-505}; + this.UC2__ = {"A":819,"H":1059,"I":409,"M":3987,"N":5775,"O":646}; + this.UC3__ = {"A":-1370,"I":2311}; + this.UC4__ = {"A":-2643,"H":1809,"I":-1032,"K":-3450,"M":3565,"N":3876,"O":6646}; + this.UC5__ = {"H":313,"I":-1238,"K":-799,"M":539,"O":-831}; + this.UC6__ = {"H":-506,"I":-253,"K":87,"M":247,"O":-387}; + this.UP1__ = {"O":-214}; + this.UP2__ = {"B":69,"O":935}; + this.UP3__ = {"B":189}; + this.UQ1__ = {"BH":21,"BI":-12,"BK":-99,"BN":142,"BO":-56,"OH":-95,"OI":477,"OK":410,"OO":-2422}; + this.UQ2__ = {"BH":216,"BI":113,"OK":1759}; + this.UQ3__ = {"BA":-479,"BH":42,"BI":1913,"BK":-7198,"BM":3160,"BN":6427,"BO":14761,"OI":-827,"ON":-3212}; + this.UW1__ = {",":156,"、":156,"「":-463,"あ":-941,"う":-127,"が":-553,"き":121,"こ":505,"で":-201,"と":-547,"ど":-123,"に":-789,"の":-185,"は":-847,"も":-466,"や":-470,"よ":182,"ら":-292,"り":208,"れ":169,"を":-446,"ん":-137,"・":-135,"主":-402,"京":-268,"区":-912,"午":871,"国":-460,"大":561,"委":729,"市":-411,"日":-141,"理":361,"生":-408,"県":-386,"都":-718,"｢":-463,"･":-135}; + this.UW2__ = {",":-829,"、":-829,"〇":892,"「":-645,"」":3145,"あ":-538,"い":505,"う":134,"お":-502,"か":1454,"が":-856,"く":-412,"こ":1141,"さ":878,"ざ":540,"し":1529,"す":-675,"せ":300,"そ":-1011,"た":188,"だ":1837,"つ":-949,"て":-291,"で":-268,"と":-981,"ど":1273,"な":1063,"に":-1764,"の":130,"は":-409,"ひ":-1273,"べ":1261,"ま":600,"も":-1263,"や":-402,"よ":1639,"り":-579,"る":-694,"れ":571,"を":-2516,"ん":2095,"ア":-587,"カ":306,"キ":568,"ッ":831,"三":-758,"不":-2150,"世":-302,"中":-968,"主":-861,"事":492,"人":-123,"会":978,"保":362,"入":548,"初":-3025,"副":-1566,"北":-3414,"区":-422,"大":-1769,"天":-865,"太":-483,"子":-1519,"学":760,"実":1023,"小":-2009,"市":-813,"年":-1060,"強":1067,"手":-1519,"揺":-1033,"政":1522,"文":-1355,"新":-1682,"日":-1815,"明":-1462,"最":-630,"朝":-1843,"本":-1650,"東":-931,"果":-665,"次":-2378,"民":-180,"気":-1740,"理":752,"発":529,"目":-1584,"相":-242,"県":-1165,"立":-763,"第":810,"米":509,"自":-1353,"行":838,"西":-744,"見":-3874,"調":1010,"議":1198,"込":3041,"開":1758,"間":-1257,"｢":-645,"｣":3145,"ｯ":831,"ｱ":-587,"ｶ":306,"ｷ":568}; + this.UW3__ = {",":4889,"1":-800,"−":-1723,"、":4889,"々":-2311,"〇":5827,"」":2670,"〓":-3573,"あ":-2696,"い":1006,"う":2342,"え":1983,"お":-4864,"か":-1163,"が":3271,"く":1004,"け":388,"げ":401,"こ":-3552,"ご":-3116,"さ":-1058,"し":-395,"す":584,"せ":3685,"そ":-5228,"た":842,"ち":-521,"っ":-1444,"つ":-1081,"て":6167,"で":2318,"と":1691,"ど":-899,"な":-2788,"に":2745,"の":4056,"は":4555,"ひ":-2171,"ふ":-1798,"へ":1199,"ほ":-5516,"ま":-4384,"み":-120,"め":1205,"も":2323,"や":-788,"よ":-202,"ら":727,"り":649,"る":5905,"れ":2773,"わ":-1207,"を":6620,"ん":-518,"ア":551,"グ":1319,"ス":874,"ッ":-1350,"ト":521,"ム":1109,"ル":1591,"ロ":2201,"ン":278,"・":-3794,"一":-1619,"下":-1759,"世":-2087,"両":3815,"中":653,"主":-758,"予":-1193,"二":974,"人":2742,"今":792,"他":1889,"以":-1368,"低":811,"何":4265,"作":-361,"保":-2439,"元":4858,"党":3593,"全":1574,"公":-3030,"六":755,"共":-1880,"円":5807,"再":3095,"分":457,"初":2475,"別":1129,"前":2286,"副":4437,"力":365,"動":-949,"務":-1872,"化":1327,"北":-1038,"区":4646,"千":-2309,"午":-783,"協":-1006,"口":483,"右":1233,"各":3588,"合":-241,"同":3906,"和":-837,"員":4513,"国":642,"型":1389,"場":1219,"外":-241,"妻":2016,"学":-1356,"安":-423,"実":-1008,"家":1078,"小":-513,"少":-3102,"州":1155,"市":3197,"平":-1804,"年":2416,"広":-1030,"府":1605,"度":1452,"建":-2352,"当":-3885,"得":1905,"思":-1291,"性":1822,"戸":-488,"指":-3973,"政":-2013,"教":-1479,"数":3222,"文":-1489,"新":1764,"日":2099,"旧":5792,"昨":-661,"時":-1248,"曜":-951,"最":-937,"月":4125,"期":360,"李":3094,"村":364,"東":-805,"核":5156,"森":2438,"業":484,"氏":2613,"民":-1694,"決":-1073,"法":1868,"海":-495,"無":979,"物":461,"特":-3850,"生":-273,"用":914,"町":1215,"的":7313,"直":-1835,"省":792,"県":6293,"知":-1528,"私":4231,"税":401,"立":-960,"第":1201,"米":7767,"系":3066,"約":3663,"級":1384,"統":-4229,"総":1163,"線":1255,"者":6457,"能":725,"自":-2869,"英":785,"見":1044,"調":-562,"財":-733,"費":1777,"車":1835,"軍":1375,"込":-1504,"通":-1136,"選":-681,"郎":1026,"郡":4404,"部":1200,"金":2163,"長":421,"開":-1432,"間":1302,"関":-1282,"雨":2009,"電":-1045,"非":2066,"駅":1620,"１":-800,"｣":2670,"･":-3794,"ｯ":-1350,"ｱ":551,"ｸﾞ":1319,"ｽ":874,"ﾄ":521,"ﾑ":1109,"ﾙ":1591,"ﾛ":2201,"ﾝ":278}; + this.UW4__ = {",":3930,".":3508,"―":-4841,"、":3930,"。":3508,"〇":4999,"「":1895,"」":3798,"〓":-5156,"あ":4752,"い":-3435,"う":-640,"え":-2514,"お":2405,"か":530,"が":6006,"き":-4482,"ぎ":-3821,"く":-3788,"け":-4376,"げ":-4734,"こ":2255,"ご":1979,"さ":2864,"し":-843,"じ":-2506,"す":-731,"ず":1251,"せ":181,"そ":4091,"た":5034,"だ":5408,"ち":-3654,"っ":-5882,"つ":-1659,"て":3994,"で":7410,"と":4547,"な":5433,"に":6499,"ぬ":1853,"ね":1413,"の":7396,"は":8578,"ば":1940,"ひ":4249,"び":-4134,"ふ":1345,"へ":6665,"べ":-744,"ほ":1464,"ま":1051,"み":-2082,"む":-882,"め":-5046,"も":4169,"ゃ":-2666,"や":2795,"ょ":-1544,"よ":3351,"ら":-2922,"り":-9726,"る":-14896,"れ":-2613,"ろ":-4570,"わ":-1783,"を":13150,"ん":-2352,"カ":2145,"コ":1789,"セ":1287,"ッ":-724,"ト":-403,"メ":-1635,"ラ":-881,"リ":-541,"ル":-856,"ン":-3637,"・":-4371,"ー":-11870,"一":-2069,"中":2210,"予":782,"事":-190,"井":-1768,"人":1036,"以":544,"会":950,"体":-1286,"作":530,"側":4292,"先":601,"党":-2006,"共":-1212,"内":584,"円":788,"初":1347,"前":1623,"副":3879,"力":-302,"動":-740,"務":-2715,"化":776,"区":4517,"協":1013,"参":1555,"合":-1834,"和":-681,"員":-910,"器":-851,"回":1500,"国":-619,"園":-1200,"地":866,"場":-1410,"塁":-2094,"士":-1413,"多":1067,"大":571,"子":-4802,"学":-1397,"定":-1057,"寺":-809,"小":1910,"屋":-1328,"山":-1500,"島":-2056,"川":-2667,"市":2771,"年":374,"庁":-4556,"後":456,"性":553,"感":916,"所":-1566,"支":856,"改":787,"政":2182,"教":704,"文":522,"方":-856,"日":1798,"時":1829,"最":845,"月":-9066,"木":-485,"来":-442,"校":-360,"業":-1043,"氏":5388,"民":-2716,"気":-910,"沢":-939,"済":-543,"物":-735,"率":672,"球":-1267,"生":-1286,"産":-1101,"田":-2900,"町":1826,"的":2586,"目":922,"省":-3485,"県":2997,"空":-867,"立":-2112,"第":788,"米":2937,"系":786,"約":2171,"経":1146,"統":-1169,"総":940,"線":-994,"署":749,"者":2145,"能":-730,"般":-852,"行":-792,"規":792,"警":-1184,"議":-244,"谷":-1000,"賞":730,"車":-1481,"軍":1158,"輪":-1433,"込":-3370,"近":929,"道":-1291,"選":2596,"郎":-4866,"都":1192,"野":-1100,"銀":-2213,"長":357,"間":-2344,"院":-2297,"際":-2604,"電":-878,"領":-1659,"題":-792,"館":-1984,"首":1749,"高":2120,"｢":1895,"｣":3798,"･":-4371,"ｯ":-724,"ｰ":-11870,"ｶ":2145,"ｺ":1789,"ｾ":1287,"ﾄ":-403,"ﾒ":-1635,"ﾗ":-881,"ﾘ":-541,"ﾙ":-856,"ﾝ":-3637}; + this.UW5__ = {",":465,".":-299,"1":-514,"E2":-32768,"]":-2762,"、":465,"。":-299,"「":363,"あ":1655,"い":331,"う":-503,"え":1199,"お":527,"か":647,"が":-421,"き":1624,"ぎ":1971,"く":312,"げ":-983,"さ":-1537,"し":-1371,"す":-852,"だ":-1186,"ち":1093,"っ":52,"つ":921,"て":-18,"で":-850,"と":-127,"ど":1682,"な":-787,"に":-1224,"の":-635,"は":-578,"べ":1001,"み":502,"め":865,"ゃ":3350,"ょ":854,"り":-208,"る":429,"れ":504,"わ":419,"を":-1264,"ん":327,"イ":241,"ル":451,"ン":-343,"中":-871,"京":722,"会":-1153,"党":-654,"務":3519,"区":-901,"告":848,"員":2104,"大":-1296,"学":-548,"定":1785,"嵐":-1304,"市":-2991,"席":921,"年":1763,"思":872,"所":-814,"挙":1618,"新":-1682,"日":218,"月":-4353,"査":932,"格":1356,"機":-1508,"氏":-1347,"田":240,"町":-3912,"的":-3149,"相":1319,"省":-1052,"県":-4003,"研":-997,"社":-278,"空":-813,"統":1955,"者":-2233,"表":663,"語":-1073,"議":1219,"選":-1018,"郎":-368,"長":786,"間":1191,"題":2368,"館":-689,"１":-514,"Ｅ２":-32768,"｢":363,"ｲ":241,"ﾙ":451,"ﾝ":-343}; + this.UW6__ = {",":227,".":808,"1":-270,"E1":306,"、":227,"。":808,"あ":-307,"う":189,"か":241,"が":-73,"く":-121,"こ":-200,"じ":1782,"す":383,"た":-428,"っ":573,"て":-1014,"で":101,"と":-105,"な":-253,"に":-149,"の":-417,"は":-236,"も":-206,"り":187,"る":-135,"を":195,"ル":-673,"ン":-496,"一":-277,"中":201,"件":-800,"会":624,"前":302,"区":1792,"員":-1212,"委":798,"学":-960,"市":887,"広":-695,"後":535,"業":-697,"相":753,"社":-507,"福":974,"空":-822,"者":1811,"連":463,"郎":1082,"１":-270,"Ｅ１":306,"ﾙ":-673,"ﾝ":-496}; + + return this; + } + TinySegmenter.prototype.ctype_ = function(str) { + for (var i in this.chartype_) { + if (str.match(this.chartype_[i][0])) { + return this.chartype_[i][1]; + } + } + return "O"; + } + + TinySegmenter.prototype.ts_ = function(v) { + if (v) { return v; } + return 0; + } + + TinySegmenter.prototype.segment = function(input) { + if (input == null || input == undefined || input == "") { + return []; + } + var result = []; + var seg = ["B3","B2","B1"]; + var ctype = ["O","O","O"]; + var o = input.split(""); + for (i = 0; i < o.length; ++i) { + seg.push(o[i]); + ctype.push(this.ctype_(o[i])) + } + seg.push("E1"); + seg.push("E2"); + seg.push("E3"); + ctype.push("O"); + ctype.push("O"); + ctype.push("O"); + var word = seg[3]; + var p1 = "U"; + var p2 = "U"; + var p3 = "U"; + for (var i = 4; i < seg.length - 3; ++i) { + var score = this.BIAS__; + var w1 = seg[i-3]; + var w2 = seg[i-2]; + var w3 = seg[i-1]; + var w4 = seg[i]; + var w5 = seg[i+1]; + var w6 = seg[i+2]; + var c1 = ctype[i-3]; + var c2 = ctype[i-2]; + var c3 = ctype[i-1]; + var c4 = ctype[i]; + var c5 = ctype[i+1]; + var c6 = ctype[i+2]; + score += this.ts_(this.UP1__[p1]); + score += this.ts_(this.UP2__[p2]); + score += this.ts_(this.UP3__[p3]); + score += this.ts_(this.BP1__[p1 + p2]); + score += this.ts_(this.BP2__[p2 + p3]); + score += this.ts_(this.UW1__[w1]); + score += this.ts_(this.UW2__[w2]); + score += this.ts_(this.UW3__[w3]); + score += this.ts_(this.UW4__[w4]); + score += this.ts_(this.UW5__[w5]); + score += this.ts_(this.UW6__[w6]); + score += this.ts_(this.BW1__[w2 + w3]); + score += this.ts_(this.BW2__[w3 + w4]); + score += this.ts_(this.BW3__[w4 + w5]); + score += this.ts_(this.TW1__[w1 + w2 + w3]); + score += this.ts_(this.TW2__[w2 + w3 + w4]); + score += this.ts_(this.TW3__[w3 + w4 + w5]); + score += this.ts_(this.TW4__[w4 + w5 + w6]); + score += this.ts_(this.UC1__[c1]); + score += this.ts_(this.UC2__[c2]); + score += this.ts_(this.UC3__[c3]); + score += this.ts_(this.UC4__[c4]); + score += this.ts_(this.UC5__[c5]); + score += this.ts_(this.UC6__[c6]); + score += this.ts_(this.BC1__[c2 + c3]); + score += this.ts_(this.BC2__[c3 + c4]); + score += this.ts_(this.BC3__[c4 + c5]); + score += this.ts_(this.TC1__[c1 + c2 + c3]); + score += this.ts_(this.TC2__[c2 + c3 + c4]); + score += this.ts_(this.TC3__[c3 + c4 + c5]); + score += this.ts_(this.TC4__[c4 + c5 + c6]); + // score += this.ts_(this.TC5__[c4 + c5 + c6]); + score += this.ts_(this.UQ1__[p1 + c1]); + score += this.ts_(this.UQ2__[p2 + c2]); + score += this.ts_(this.UQ3__[p3 + c3]); + score += this.ts_(this.BQ1__[p2 + c2 + c3]); + score += this.ts_(this.BQ2__[p2 + c3 + c4]); + score += this.ts_(this.BQ3__[p3 + c2 + c3]); + score += this.ts_(this.BQ4__[p3 + c3 + c4]); + score += this.ts_(this.TQ1__[p2 + c1 + c2 + c3]); + score += this.ts_(this.TQ2__[p2 + c2 + c3 + c4]); + score += this.ts_(this.TQ3__[p3 + c1 + c2 + c3]); + score += this.ts_(this.TQ4__[p3 + c2 + c3 + c4]); + var p = "O"; + if (score > 0) { + result.push(word); + word = ""; + p = "B"; + } + p1 = p2; + p2 = p3; + p3 = p; + word += seg[i]; + } + result.push(word); + + return result; + } + + lunr.TinySegmenter = TinySegmenter; + }; + +})); \ No newline at end of file diff --git a/assets/javascripts/lunr/wordcut.js b/assets/javascripts/lunr/wordcut.js new file mode 100644 index 00000000..0d898c9e --- /dev/null +++ b/assets/javascripts/lunr/wordcut.js @@ -0,0 +1,6708 @@ +(function(f){if(typeof exports==="object"&&typeof module!=="undefined"){module.exports=f()}else if(typeof define==="function"&&define.amd){define([],f)}else{var g;if(typeof window!=="undefined"){g=window}else if(typeof global!=="undefined"){g=global}else if(typeof self!=="undefined"){g=self}else{g=this}(g.lunr || (g.lunr = {})).wordcut = f()}})(function(){var define,module,exports;return (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o 1; + }) + this.addWords(words, false) + } + if(finalize){ + this.finalizeDict(); + } + }, + + dictSeek: function (l, r, ch, strOffset, pos) { + var ans = null; + while (l <= r) { + var m = Math.floor((l + r) / 2), + dict_item = this.dict[m], + len = dict_item.length; + if (len <= strOffset) { + l = m + 1; + } else { + var ch_ = dict_item[strOffset]; + if (ch_ < ch) { + l = m + 1; + } else if (ch_ > ch) { + r = m - 1; + } else { + ans = m; + if (pos == LEFT) { + r = m - 1; + } else { + l = m + 1; + } + } + } + } + return ans; + }, + + isFinal: function (acceptor) { + return this.dict[acceptor.l].length == acceptor.strOffset; + }, + + createAcceptor: function () { + return { + l: 0, + r: this.dict.length - 1, + strOffset: 0, + isFinal: false, + dict: this, + transit: function (ch) { + return this.dict.transit(this, ch); + }, + isError: false, + tag: "DICT", + w: 1, + type: "DICT" + }; + }, + + transit: function (acceptor, ch) { + var l = this.dictSeek(acceptor.l, + acceptor.r, + ch, + acceptor.strOffset, + LEFT); + if (l !== null) { + var r = this.dictSeek(l, + acceptor.r, + ch, + acceptor.strOffset, + RIGHT); + acceptor.l = l; + acceptor.r = r; + acceptor.strOffset++; + acceptor.isFinal = this.isFinal(acceptor); + } else { + acceptor.isError = true; + } + return acceptor; + }, + + sortuniq: function(a){ + return a.sort().filter(function(item, pos, arr){ + return !pos || item != arr[pos - 1]; + }) + }, + + flatten: function(a){ + //[[1,2],[3]] -> [1,2,3] + return [].concat.apply([], a); + } +}; +module.exports = WordcutDict; + +}).call(this,"/dist/tmp") +},{"glob":16,"path":22}],3:[function(require,module,exports){ +var WordRule = { + createAcceptor: function(tag) { + if (tag["WORD_RULE"]) + return null; + + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + var lch = ch.toLowerCase(); + if (lch >= "a" && lch <= "z") { + this.isFinal = true; + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "WORD_RULE", + type: "WORD_RULE", + w: 1}; + } +}; + +var NumberRule = { + createAcceptor: function(tag) { + if (tag["NUMBER_RULE"]) + return null; + + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + if (ch >= "0" && ch <= "9") { + this.isFinal = true; + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "NUMBER_RULE", + type: "NUMBER_RULE", + w: 1}; + } +}; + +var SpaceRule = { + tag: "SPACE_RULE", + createAcceptor: function(tag) { + + if (tag["SPACE_RULE"]) + return null; + + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + if (ch == " " || ch == "\t" || ch == "\r" || ch == "\n" || + ch == "\u00A0" || ch=="\u2003"//nbsp and emsp + ) { + this.isFinal = true; + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: SpaceRule.tag, + w: 1, + type: "SPACE_RULE"}; + } +} + +var SingleSymbolRule = { + tag: "SINSYM", + createAcceptor: function(tag) { + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + if (this.strOffset == 0 && ch.match(/^[\@\(\)\/\,\-\."`]$/)) { + this.isFinal = true; + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "SINSYM", + w: 1, + type: "SINSYM"}; + } +} + + +var LatinRules = [WordRule, SpaceRule, SingleSymbolRule, NumberRule]; + +module.exports = LatinRules; + +},{}],4:[function(require,module,exports){ +var _ = require("underscore") + , WordcutCore = require("./wordcut_core"); +var PathInfoBuilder = { + + /* + buildByPartAcceptors: function(path, acceptors, i) { + var + var genInfos = partAcceptors.reduce(function(genInfos, acceptor) { + + }, []); + + return genInfos; + } + */ + + buildByAcceptors: function(path, finalAcceptors, i) { + var self = this; + var infos = finalAcceptors.map(function(acceptor) { + var p = i - acceptor.strOffset + 1 + , _info = path[p]; + + var info = {p: p, + mw: _info.mw + (acceptor.mw === undefined ? 0 : acceptor.mw), + w: acceptor.w + _info.w, + unk: (acceptor.unk ? acceptor.unk : 0) + _info.unk, + type: acceptor.type}; + + if (acceptor.type == "PART") { + for(var j = p + 1; j <= i; j++) { + path[j].merge = p; + } + info.merge = p; + } + + return info; + }); + return infos.filter(function(info) { return info; }); + }, + + fallback: function(path, leftBoundary, text, i) { + var _info = path[leftBoundary]; + if (text[i].match(/[\u0E48-\u0E4E]/)) { + if (leftBoundary != 0) + leftBoundary = path[leftBoundary].p; + return {p: leftBoundary, + mw: 0, + w: 1 + _info.w, + unk: 1 + _info.unk, + type: "UNK"}; +/* } else if(leftBoundary > 0 && path[leftBoundary].type !== "UNK") { + leftBoundary = path[leftBoundary].p; + return {p: leftBoundary, + w: 1 + _info.w, + unk: 1 + _info.unk, + type: "UNK"}; */ + } else { + return {p: leftBoundary, + mw: _info.mw, + w: 1 + _info.w, + unk: 1 + _info.unk, + type: "UNK"}; + } + }, + + build: function(path, finalAcceptors, i, leftBoundary, text) { + var basicPathInfos = this.buildByAcceptors(path, finalAcceptors, i); + if (basicPathInfos.length > 0) { + return basicPathInfos; + } else { + return [this.fallback(path, leftBoundary, text, i)]; + } + } +}; + +module.exports = function() { + return _.clone(PathInfoBuilder); +} + +},{"./wordcut_core":8,"underscore":25}],5:[function(require,module,exports){ +var _ = require("underscore"); + + +var PathSelector = { + selectPath: function(paths) { + var path = paths.reduce(function(selectedPath, path) { + if (selectedPath == null) { + return path; + } else { + if (path.unk < selectedPath.unk) + return path; + if (path.unk == selectedPath.unk) { + if (path.mw < selectedPath.mw) + return path + if (path.mw == selectedPath.mw) { + if (path.w < selectedPath.w) + return path; + } + } + return selectedPath; + } + }, null); + return path; + }, + + createPath: function() { + return [{p:null, w:0, unk:0, type: "INIT", mw:0}]; + } +}; + +module.exports = function() { + return _.clone(PathSelector); +}; + +},{"underscore":25}],6:[function(require,module,exports){ +function isMatch(pat, offset, ch) { + if (pat.length <= offset) + return false; + var _ch = pat[offset]; + return _ch == ch || + (_ch.match(/[กข]/) && ch.match(/[ก-ฮ]/)) || + (_ch.match(/[มบ]/) && ch.match(/[ก-ฮ]/)) || + (_ch.match(/\u0E49/) && ch.match(/[\u0E48-\u0E4B]/)); +} + +var Rule0 = { + pat: "เหก็ม", + createAcceptor: function(tag) { + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + if (isMatch(Rule0.pat, this.strOffset,ch)) { + this.isFinal = (this.strOffset + 1 == Rule0.pat.length); + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "THAI_RULE", + type: "THAI_RULE", + w: 1}; + } +}; + +var PartRule = { + createAcceptor: function(tag) { + return {strOffset: 0, + patterns: [ + "แก", "เก", "ก้", "กก์", "กา", "กี", "กิ", "กืก" + ], + isFinal: false, + transit: function(ch) { + var offset = this.strOffset; + this.patterns = this.patterns.filter(function(pat) { + return isMatch(pat, offset, ch); + }); + + if (this.patterns.length > 0) { + var len = 1 + offset; + this.isFinal = this.patterns.some(function(pat) { + return pat.length == len; + }); + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "PART", + type: "PART", + unk: 1, + w: 1}; + } +}; + +var ThaiRules = [Rule0, PartRule]; + +module.exports = ThaiRules; + +},{}],7:[function(require,module,exports){ +var sys = require("sys") + , WordcutDict = require("./dict") + , WordcutCore = require("./wordcut_core") + , PathInfoBuilder = require("./path_info_builder") + , PathSelector = require("./path_selector") + , Acceptors = require("./acceptors") + , latinRules = require("./latin_rules") + , thaiRules = require("./thai_rules") + , _ = require("underscore"); + + +var Wordcut = Object.create(WordcutCore); +Wordcut.defaultPathInfoBuilder = PathInfoBuilder; +Wordcut.defaultPathSelector = PathSelector; +Wordcut.defaultAcceptors = Acceptors; +Wordcut.defaultLatinRules = latinRules; +Wordcut.defaultThaiRules = thaiRules; +Wordcut.defaultDict = WordcutDict; + + +Wordcut.initNoDict = function(dict_path) { + var self = this; + self.pathInfoBuilder = new self.defaultPathInfoBuilder; + self.pathSelector = new self.defaultPathSelector; + self.acceptors = new self.defaultAcceptors; + self.defaultLatinRules.forEach(function(rule) { + self.acceptors.creators.push(rule); + }); + self.defaultThaiRules.forEach(function(rule) { + self.acceptors.creators.push(rule); + }); +}; + +Wordcut.init = function(dict_path, withDefault, additionalWords) { + withDefault = withDefault || false; + this.initNoDict(); + var dict = _.clone(this.defaultDict); + dict.init(dict_path, withDefault, additionalWords); + this.acceptors.creators.push(dict); +}; + +module.exports = Wordcut; + +},{"./acceptors":1,"./dict":2,"./latin_rules":3,"./path_info_builder":4,"./path_selector":5,"./thai_rules":6,"./wordcut_core":8,"sys":28,"underscore":25}],8:[function(require,module,exports){ +var WordcutCore = { + + buildPath: function(text) { + var self = this + , path = self.pathSelector.createPath() + , leftBoundary = 0; + self.acceptors.reset(); + for (var i = 0; i < text.length; i++) { + var ch = text[i]; + self.acceptors.transit(ch); + + var possiblePathInfos = self + .pathInfoBuilder + .build(path, + self.acceptors.getFinalAcceptors(), + i, + leftBoundary, + text); + var selectedPath = self.pathSelector.selectPath(possiblePathInfos) + + path.push(selectedPath); + if (selectedPath.type !== "UNK") { + leftBoundary = i; + } + } + return path; + }, + + pathToRanges: function(path) { + var e = path.length - 1 + , ranges = []; + + while (e > 0) { + var info = path[e] + , s = info.p; + + if (info.merge !== undefined && ranges.length > 0) { + var r = ranges[ranges.length - 1]; + r.s = info.merge; + s = r.s; + } else { + ranges.push({s:s, e:e}); + } + e = s; + } + return ranges.reverse(); + }, + + rangesToText: function(text, ranges, delimiter) { + return ranges.map(function(r) { + return text.substring(r.s, r.e); + }).join(delimiter); + }, + + cut: function(text, delimiter) { + var path = this.buildPath(text) + , ranges = this.pathToRanges(path); + return this + .rangesToText(text, ranges, + (delimiter === undefined ? "|" : delimiter)); + }, + + cutIntoRanges: function(text, noText) { + var path = this.buildPath(text) + , ranges = this.pathToRanges(path); + + if (!noText) { + ranges.forEach(function(r) { + r.text = text.substring(r.s, r.e); + }); + } + return ranges; + }, + + cutIntoArray: function(text) { + var path = this.buildPath(text) + , ranges = this.pathToRanges(path); + + return ranges.map(function(r) { + return text.substring(r.s, r.e) + }); + } +}; + +module.exports = WordcutCore; + +},{}],9:[function(require,module,exports){ +// http://wiki.commonjs.org/wiki/Unit_Testing/1.0 +// +// THIS IS NOT TESTED NOR LIKELY TO WORK OUTSIDE V8! +// +// Originally from narwhal.js (http://narwhaljs.org) +// Copyright (c) 2009 Thomas Robinson <280north.com> +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the 'Software'), to +// deal in the Software without restriction, including without limitation the +// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +// sell copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN +// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// when used in node, this will actually load the util module we depend on +// versus loading the builtin util module as happens otherwise +// this is a bug in node module loading as far as I am concerned +var util = require('util/'); + +var pSlice = Array.prototype.slice; +var hasOwn = Object.prototype.hasOwnProperty; + +// 1. The assert module provides functions that throw +// AssertionError's when particular conditions are not met. The +// assert module must conform to the following interface. + +var assert = module.exports = ok; + +// 2. The AssertionError is defined in assert. +// new assert.AssertionError({ message: message, +// actual: actual, +// expected: expected }) + +assert.AssertionError = function AssertionError(options) { + this.name = 'AssertionError'; + this.actual = options.actual; + this.expected = options.expected; + this.operator = options.operator; + if (options.message) { + this.message = options.message; + this.generatedMessage = false; + } else { + this.message = getMessage(this); + this.generatedMessage = true; + } + var stackStartFunction = options.stackStartFunction || fail; + + if (Error.captureStackTrace) { + Error.captureStackTrace(this, stackStartFunction); + } + else { + // non v8 browsers so we can have a stacktrace + var err = new Error(); + if (err.stack) { + var out = err.stack; + + // try to strip useless frames + var fn_name = stackStartFunction.name; + var idx = out.indexOf('\n' + fn_name); + if (idx >= 0) { + // once we have located the function frame + // we need to strip out everything before it (and its line) + var next_line = out.indexOf('\n', idx + 1); + out = out.substring(next_line + 1); + } + + this.stack = out; + } + } +}; + +// assert.AssertionError instanceof Error +util.inherits(assert.AssertionError, Error); + +function replacer(key, value) { + if (util.isUndefined(value)) { + return '' + value; + } + if (util.isNumber(value) && !isFinite(value)) { + return value.toString(); + } + if (util.isFunction(value) || util.isRegExp(value)) { + return value.toString(); + } + return value; +} + +function truncate(s, n) { + if (util.isString(s)) { + return s.length < n ? s : s.slice(0, n); + } else { + return s; + } +} + +function getMessage(self) { + return truncate(JSON.stringify(self.actual, replacer), 128) + ' ' + + self.operator + ' ' + + truncate(JSON.stringify(self.expected, replacer), 128); +} + +// At present only the three keys mentioned above are used and +// understood by the spec. Implementations or sub modules can pass +// other keys to the AssertionError's constructor - they will be +// ignored. + +// 3. All of the following functions must throw an AssertionError +// when a corresponding condition is not met, with a message that +// may be undefined if not provided. All assertion methods provide +// both the actual and expected values to the assertion error for +// display purposes. + +function fail(actual, expected, message, operator, stackStartFunction) { + throw new assert.AssertionError({ + message: message, + actual: actual, + expected: expected, + operator: operator, + stackStartFunction: stackStartFunction + }); +} + +// EXTENSION! allows for well behaved errors defined elsewhere. +assert.fail = fail; + +// 4. Pure assertion tests whether a value is truthy, as determined +// by !!guard. +// assert.ok(guard, message_opt); +// This statement is equivalent to assert.equal(true, !!guard, +// message_opt);. To test strictly for the value true, use +// assert.strictEqual(true, guard, message_opt);. + +function ok(value, message) { + if (!value) fail(value, true, message, '==', assert.ok); +} +assert.ok = ok; + +// 5. The equality assertion tests shallow, coercive equality with +// ==. +// assert.equal(actual, expected, message_opt); + +assert.equal = function equal(actual, expected, message) { + if (actual != expected) fail(actual, expected, message, '==', assert.equal); +}; + +// 6. The non-equality assertion tests for whether two objects are not equal +// with != assert.notEqual(actual, expected, message_opt); + +assert.notEqual = function notEqual(actual, expected, message) { + if (actual == expected) { + fail(actual, expected, message, '!=', assert.notEqual); + } +}; + +// 7. The equivalence assertion tests a deep equality relation. +// assert.deepEqual(actual, expected, message_opt); + +assert.deepEqual = function deepEqual(actual, expected, message) { + if (!_deepEqual(actual, expected)) { + fail(actual, expected, message, 'deepEqual', assert.deepEqual); + } +}; + +function _deepEqual(actual, expected) { + // 7.1. All identical values are equivalent, as determined by ===. + if (actual === expected) { + return true; + + } else if (util.isBuffer(actual) && util.isBuffer(expected)) { + if (actual.length != expected.length) return false; + + for (var i = 0; i < actual.length; i++) { + if (actual[i] !== expected[i]) return false; + } + + return true; + + // 7.2. If the expected value is a Date object, the actual value is + // equivalent if it is also a Date object that refers to the same time. + } else if (util.isDate(actual) && util.isDate(expected)) { + return actual.getTime() === expected.getTime(); + + // 7.3 If the expected value is a RegExp object, the actual value is + // equivalent if it is also a RegExp object with the same source and + // properties (`global`, `multiline`, `lastIndex`, `ignoreCase`). + } else if (util.isRegExp(actual) && util.isRegExp(expected)) { + return actual.source === expected.source && + actual.global === expected.global && + actual.multiline === expected.multiline && + actual.lastIndex === expected.lastIndex && + actual.ignoreCase === expected.ignoreCase; + + // 7.4. Other pairs that do not both pass typeof value == 'object', + // equivalence is determined by ==. + } else if (!util.isObject(actual) && !util.isObject(expected)) { + return actual == expected; + + // 7.5 For all other Object pairs, including Array objects, equivalence is + // determined by having the same number of owned properties (as verified + // with Object.prototype.hasOwnProperty.call), the same set of keys + // (although not necessarily the same order), equivalent values for every + // corresponding key, and an identical 'prototype' property. Note: this + // accounts for both named and indexed properties on Arrays. + } else { + return objEquiv(actual, expected); + } +} + +function isArguments(object) { + return Object.prototype.toString.call(object) == '[object Arguments]'; +} + +function objEquiv(a, b) { + if (util.isNullOrUndefined(a) || util.isNullOrUndefined(b)) + return false; + // an identical 'prototype' property. + if (a.prototype !== b.prototype) return false; + // if one is a primitive, the other must be same + if (util.isPrimitive(a) || util.isPrimitive(b)) { + return a === b; + } + var aIsArgs = isArguments(a), + bIsArgs = isArguments(b); + if ((aIsArgs && !bIsArgs) || (!aIsArgs && bIsArgs)) + return false; + if (aIsArgs) { + a = pSlice.call(a); + b = pSlice.call(b); + return _deepEqual(a, b); + } + var ka = objectKeys(a), + kb = objectKeys(b), + key, i; + // having the same number of owned properties (keys incorporates + // hasOwnProperty) + if (ka.length != kb.length) + return false; + //the same set of keys (although not necessarily the same order), + ka.sort(); + kb.sort(); + //~~~cheap key test + for (i = ka.length - 1; i >= 0; i--) { + if (ka[i] != kb[i]) + return false; + } + //equivalent values for every corresponding key, and + //~~~possibly expensive deep test + for (i = ka.length - 1; i >= 0; i--) { + key = ka[i]; + if (!_deepEqual(a[key], b[key])) return false; + } + return true; +} + +// 8. The non-equivalence assertion tests for any deep inequality. +// assert.notDeepEqual(actual, expected, message_opt); + +assert.notDeepEqual = function notDeepEqual(actual, expected, message) { + if (_deepEqual(actual, expected)) { + fail(actual, expected, message, 'notDeepEqual', assert.notDeepEqual); + } +}; + +// 9. The strict equality assertion tests strict equality, as determined by ===. +// assert.strictEqual(actual, expected, message_opt); + +assert.strictEqual = function strictEqual(actual, expected, message) { + if (actual !== expected) { + fail(actual, expected, message, '===', assert.strictEqual); + } +}; + +// 10. The strict non-equality assertion tests for strict inequality, as +// determined by !==. assert.notStrictEqual(actual, expected, message_opt); + +assert.notStrictEqual = function notStrictEqual(actual, expected, message) { + if (actual === expected) { + fail(actual, expected, message, '!==', assert.notStrictEqual); + } +}; + +function expectedException(actual, expected) { + if (!actual || !expected) { + return false; + } + + if (Object.prototype.toString.call(expected) == '[object RegExp]') { + return expected.test(actual); + } else if (actual instanceof expected) { + return true; + } else if (expected.call({}, actual) === true) { + return true; + } + + return false; +} + +function _throws(shouldThrow, block, expected, message) { + var actual; + + if (util.isString(expected)) { + message = expected; + expected = null; + } + + try { + block(); + } catch (e) { + actual = e; + } + + message = (expected && expected.name ? ' (' + expected.name + ').' : '.') + + (message ? ' ' + message : '.'); + + if (shouldThrow && !actual) { + fail(actual, expected, 'Missing expected exception' + message); + } + + if (!shouldThrow && expectedException(actual, expected)) { + fail(actual, expected, 'Got unwanted exception' + message); + } + + if ((shouldThrow && actual && expected && + !expectedException(actual, expected)) || (!shouldThrow && actual)) { + throw actual; + } +} + +// 11. Expected to throw an error: +// assert.throws(block, Error_opt, message_opt); + +assert.throws = function(block, /*optional*/error, /*optional*/message) { + _throws.apply(this, [true].concat(pSlice.call(arguments))); +}; + +// EXTENSION! This is annoying to write outside this module. +assert.doesNotThrow = function(block, /*optional*/message) { + _throws.apply(this, [false].concat(pSlice.call(arguments))); +}; + +assert.ifError = function(err) { if (err) {throw err;}}; + +var objectKeys = Object.keys || function (obj) { + var keys = []; + for (var key in obj) { + if (hasOwn.call(obj, key)) keys.push(key); + } + return keys; +}; + +},{"util/":28}],10:[function(require,module,exports){ +'use strict'; +module.exports = balanced; +function balanced(a, b, str) { + if (a instanceof RegExp) a = maybeMatch(a, str); + if (b instanceof RegExp) b = maybeMatch(b, str); + + var r = range(a, b, str); + + return r && { + start: r[0], + end: r[1], + pre: str.slice(0, r[0]), + body: str.slice(r[0] + a.length, r[1]), + post: str.slice(r[1] + b.length) + }; +} + +function maybeMatch(reg, str) { + var m = str.match(reg); + return m ? m[0] : null; +} + +balanced.range = range; +function range(a, b, str) { + var begs, beg, left, right, result; + var ai = str.indexOf(a); + var bi = str.indexOf(b, ai + 1); + var i = ai; + + if (ai >= 0 && bi > 0) { + begs = []; + left = str.length; + + while (i >= 0 && !result) { + if (i == ai) { + begs.push(i); + ai = str.indexOf(a, i + 1); + } else if (begs.length == 1) { + result = [ begs.pop(), bi ]; + } else { + beg = begs.pop(); + if (beg < left) { + left = beg; + right = bi; + } + + bi = str.indexOf(b, i + 1); + } + + i = ai < bi && ai >= 0 ? ai : bi; + } + + if (begs.length) { + result = [ left, right ]; + } + } + + return result; +} + +},{}],11:[function(require,module,exports){ +var concatMap = require('concat-map'); +var balanced = require('balanced-match'); + +module.exports = expandTop; + +var escSlash = '\0SLASH'+Math.random()+'\0'; +var escOpen = '\0OPEN'+Math.random()+'\0'; +var escClose = '\0CLOSE'+Math.random()+'\0'; +var escComma = '\0COMMA'+Math.random()+'\0'; +var escPeriod = '\0PERIOD'+Math.random()+'\0'; + +function numeric(str) { + return parseInt(str, 10) == str + ? parseInt(str, 10) + : str.charCodeAt(0); +} + +function escapeBraces(str) { + return str.split('\\\\').join(escSlash) + .split('\\{').join(escOpen) + .split('\\}').join(escClose) + .split('\\,').join(escComma) + .split('\\.').join(escPeriod); +} + +function unescapeBraces(str) { + return str.split(escSlash).join('\\') + .split(escOpen).join('{') + .split(escClose).join('}') + .split(escComma).join(',') + .split(escPeriod).join('.'); +} + + +// Basically just str.split(","), but handling cases +// where we have nested braced sections, which should be +// treated as individual members, like {a,{b,c},d} +function parseCommaParts(str) { + if (!str) + return ['']; + + var parts = []; + var m = balanced('{', '}', str); + + if (!m) + return str.split(','); + + var pre = m.pre; + var body = m.body; + var post = m.post; + var p = pre.split(','); + + p[p.length-1] += '{' + body + '}'; + var postParts = parseCommaParts(post); + if (post.length) { + p[p.length-1] += postParts.shift(); + p.push.apply(p, postParts); + } + + parts.push.apply(parts, p); + + return parts; +} + +function expandTop(str) { + if (!str) + return []; + + // I don't know why Bash 4.3 does this, but it does. + // Anything starting with {} will have the first two bytes preserved + // but *only* at the top level, so {},a}b will not expand to anything, + // but a{},b}c will be expanded to [a}c,abc]. + // One could argue that this is a bug in Bash, but since the goal of + // this module is to match Bash's rules, we escape a leading {} + if (str.substr(0, 2) === '{}') { + str = '\\{\\}' + str.substr(2); + } + + return expand(escapeBraces(str), true).map(unescapeBraces); +} + +function identity(e) { + return e; +} + +function embrace(str) { + return '{' + str + '}'; +} +function isPadded(el) { + return /^-?0\d/.test(el); +} + +function lte(i, y) { + return i <= y; +} +function gte(i, y) { + return i >= y; +} + +function expand(str, isTop) { + var expansions = []; + + var m = balanced('{', '}', str); + if (!m || /\$$/.test(m.pre)) return [str]; + + var isNumericSequence = /^-?\d+\.\.-?\d+(?:\.\.-?\d+)?$/.test(m.body); + var isAlphaSequence = /^[a-zA-Z]\.\.[a-zA-Z](?:\.\.-?\d+)?$/.test(m.body); + var isSequence = isNumericSequence || isAlphaSequence; + var isOptions = m.body.indexOf(',') >= 0; + if (!isSequence && !isOptions) { + // {a},b} + if (m.post.match(/,.*\}/)) { + str = m.pre + '{' + m.body + escClose + m.post; + return expand(str); + } + return [str]; + } + + var n; + if (isSequence) { + n = m.body.split(/\.\./); + } else { + n = parseCommaParts(m.body); + if (n.length === 1) { + // x{{a,b}}y ==> x{a}y x{b}y + n = expand(n[0], false).map(embrace); + if (n.length === 1) { + var post = m.post.length + ? expand(m.post, false) + : ['']; + return post.map(function(p) { + return m.pre + n[0] + p; + }); + } + } + } + + // at this point, n is the parts, and we know it's not a comma set + // with a single entry. + + // no need to expand pre, since it is guaranteed to be free of brace-sets + var pre = m.pre; + var post = m.post.length + ? expand(m.post, false) + : ['']; + + var N; + + if (isSequence) { + var x = numeric(n[0]); + var y = numeric(n[1]); + var width = Math.max(n[0].length, n[1].length) + var incr = n.length == 3 + ? Math.abs(numeric(n[2])) + : 1; + var test = lte; + var reverse = y < x; + if (reverse) { + incr *= -1; + test = gte; + } + var pad = n.some(isPadded); + + N = []; + + for (var i = x; test(i, y); i += incr) { + var c; + if (isAlphaSequence) { + c = String.fromCharCode(i); + if (c === '\\') + c = ''; + } else { + c = String(i); + if (pad) { + var need = width - c.length; + if (need > 0) { + var z = new Array(need + 1).join('0'); + if (i < 0) + c = '-' + z + c.slice(1); + else + c = z + c; + } + } + } + N.push(c); + } + } else { + N = concatMap(n, function(el) { return expand(el, false) }); + } + + for (var j = 0; j < N.length; j++) { + for (var k = 0; k < post.length; k++) { + var expansion = pre + N[j] + post[k]; + if (!isTop || isSequence || expansion) + expansions.push(expansion); + } + } + + return expansions; +} + + +},{"balanced-match":10,"concat-map":13}],12:[function(require,module,exports){ + +},{}],13:[function(require,module,exports){ +module.exports = function (xs, fn) { + var res = []; + for (var i = 0; i < xs.length; i++) { + var x = fn(xs[i], i); + if (isArray(x)) res.push.apply(res, x); + else res.push(x); + } + return res; +}; + +var isArray = Array.isArray || function (xs) { + return Object.prototype.toString.call(xs) === '[object Array]'; +}; + +},{}],14:[function(require,module,exports){ +// Copyright Joyent, Inc. and other Node contributors. +// +// Permission is hereby granted, free of charge, to any person obtaining a +// copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to permit +// persons to whom the Software is furnished to do so, subject to the +// following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +// USE OR OTHER DEALINGS IN THE SOFTWARE. + +function EventEmitter() { + this._events = this._events || {}; + this._maxListeners = this._maxListeners || undefined; +} +module.exports = EventEmitter; + +// Backwards-compat with node 0.10.x +EventEmitter.EventEmitter = EventEmitter; + +EventEmitter.prototype._events = undefined; +EventEmitter.prototype._maxListeners = undefined; + +// By default EventEmitters will print a warning if more than 10 listeners are +// added to it. This is a useful default which helps finding memory leaks. +EventEmitter.defaultMaxListeners = 10; + +// Obviously not all Emitters should be limited to 10. This function allows +// that to be increased. Set to zero for unlimited. +EventEmitter.prototype.setMaxListeners = function(n) { + if (!isNumber(n) || n < 0 || isNaN(n)) + throw TypeError('n must be a positive number'); + this._maxListeners = n; + return this; +}; + +EventEmitter.prototype.emit = function(type) { + var er, handler, len, args, i, listeners; + + if (!this._events) + this._events = {}; + + // If there is no 'error' event listener then throw. + if (type === 'error') { + if (!this._events.error || + (isObject(this._events.error) && !this._events.error.length)) { + er = arguments[1]; + if (er instanceof Error) { + throw er; // Unhandled 'error' event + } + throw TypeError('Uncaught, unspecified "error" event.'); + } + } + + handler = this._events[type]; + + if (isUndefined(handler)) + return false; + + if (isFunction(handler)) { + switch (arguments.length) { + // fast cases + case 1: + handler.call(this); + break; + case 2: + handler.call(this, arguments[1]); + break; + case 3: + handler.call(this, arguments[1], arguments[2]); + break; + // slower + default: + len = arguments.length; + args = new Array(len - 1); + for (i = 1; i < len; i++) + args[i - 1] = arguments[i]; + handler.apply(this, args); + } + } else if (isObject(handler)) { + len = arguments.length; + args = new Array(len - 1); + for (i = 1; i < len; i++) + args[i - 1] = arguments[i]; + + listeners = handler.slice(); + len = listeners.length; + for (i = 0; i < len; i++) + listeners[i].apply(this, args); + } + + return true; +}; + +EventEmitter.prototype.addListener = function(type, listener) { + var m; + + if (!isFunction(listener)) + throw TypeError('listener must be a function'); + + if (!this._events) + this._events = {}; + + // To avoid recursion in the case that type === "newListener"! Before + // adding it to the listeners, first emit "newListener". + if (this._events.newListener) + this.emit('newListener', type, + isFunction(listener.listener) ? + listener.listener : listener); + + if (!this._events[type]) + // Optimize the case of one listener. Don't need the extra array object. + this._events[type] = listener; + else if (isObject(this._events[type])) + // If we've already got an array, just append. + this._events[type].push(listener); + else + // Adding the second element, need to change to array. + this._events[type] = [this._events[type], listener]; + + // Check for listener leak + if (isObject(this._events[type]) && !this._events[type].warned) { + var m; + if (!isUndefined(this._maxListeners)) { + m = this._maxListeners; + } else { + m = EventEmitter.defaultMaxListeners; + } + + if (m && m > 0 && this._events[type].length > m) { + this._events[type].warned = true; + console.error('(node) warning: possible EventEmitter memory ' + + 'leak detected. %d listeners added. ' + + 'Use emitter.setMaxListeners() to increase limit.', + this._events[type].length); + if (typeof console.trace === 'function') { + // not supported in IE 10 + console.trace(); + } + } + } + + return this; +}; + +EventEmitter.prototype.on = EventEmitter.prototype.addListener; + +EventEmitter.prototype.once = function(type, listener) { + if (!isFunction(listener)) + throw TypeError('listener must be a function'); + + var fired = false; + + function g() { + this.removeListener(type, g); + + if (!fired) { + fired = true; + listener.apply(this, arguments); + } + } + + g.listener = listener; + this.on(type, g); + + return this; +}; + +// emits a 'removeListener' event iff the listener was removed +EventEmitter.prototype.removeListener = function(type, listener) { + var list, position, length, i; + + if (!isFunction(listener)) + throw TypeError('listener must be a function'); + + if (!this._events || !this._events[type]) + return this; + + list = this._events[type]; + length = list.length; + position = -1; + + if (list === listener || + (isFunction(list.listener) && list.listener === listener)) { + delete this._events[type]; + if (this._events.removeListener) + this.emit('removeListener', type, listener); + + } else if (isObject(list)) { + for (i = length; i-- > 0;) { + if (list[i] === listener || + (list[i].listener && list[i].listener === listener)) { + position = i; + break; + } + } + + if (position < 0) + return this; + + if (list.length === 1) { + list.length = 0; + delete this._events[type]; + } else { + list.splice(position, 1); + } + + if (this._events.removeListener) + this.emit('removeListener', type, listener); + } + + return this; +}; + +EventEmitter.prototype.removeAllListeners = function(type) { + var key, listeners; + + if (!this._events) + return this; + + // not listening for removeListener, no need to emit + if (!this._events.removeListener) { + if (arguments.length === 0) + this._events = {}; + else if (this._events[type]) + delete this._events[type]; + return this; + } + + // emit removeListener for all listeners on all events + if (arguments.length === 0) { + for (key in this._events) { + if (key === 'removeListener') continue; + this.removeAllListeners(key); + } + this.removeAllListeners('removeListener'); + this._events = {}; + return this; + } + + listeners = this._events[type]; + + if (isFunction(listeners)) { + this.removeListener(type, listeners); + } else { + // LIFO order + while (listeners.length) + this.removeListener(type, listeners[listeners.length - 1]); + } + delete this._events[type]; + + return this; +}; + +EventEmitter.prototype.listeners = function(type) { + var ret; + if (!this._events || !this._events[type]) + ret = []; + else if (isFunction(this._events[type])) + ret = [this._events[type]]; + else + ret = this._events[type].slice(); + return ret; +}; + +EventEmitter.listenerCount = function(emitter, type) { + var ret; + if (!emitter._events || !emitter._events[type]) + ret = 0; + else if (isFunction(emitter._events[type])) + ret = 1; + else + ret = emitter._events[type].length; + return ret; +}; + +function isFunction(arg) { + return typeof arg === 'function'; +} + +function isNumber(arg) { + return typeof arg === 'number'; +} + +function isObject(arg) { + return typeof arg === 'object' && arg !== null; +} + +function isUndefined(arg) { + return arg === void 0; +} + +},{}],15:[function(require,module,exports){ +(function (process){ +exports.alphasort = alphasort +exports.alphasorti = alphasorti +exports.setopts = setopts +exports.ownProp = ownProp +exports.makeAbs = makeAbs +exports.finish = finish +exports.mark = mark +exports.isIgnored = isIgnored +exports.childrenIgnored = childrenIgnored + +function ownProp (obj, field) { + return Object.prototype.hasOwnProperty.call(obj, field) +} + +var path = require("path") +var minimatch = require("minimatch") +var isAbsolute = require("path-is-absolute") +var Minimatch = minimatch.Minimatch + +function alphasorti (a, b) { + return a.toLowerCase().localeCompare(b.toLowerCase()) +} + +function alphasort (a, b) { + return a.localeCompare(b) +} + +function setupIgnores (self, options) { + self.ignore = options.ignore || [] + + if (!Array.isArray(self.ignore)) + self.ignore = [self.ignore] + + if (self.ignore.length) { + self.ignore = self.ignore.map(ignoreMap) + } +} + +function ignoreMap (pattern) { + var gmatcher = null + if (pattern.slice(-3) === '/**') { + var gpattern = pattern.replace(/(\/\*\*)+$/, '') + gmatcher = new Minimatch(gpattern) + } + + return { + matcher: new Minimatch(pattern), + gmatcher: gmatcher + } +} + +function setopts (self, pattern, options) { + if (!options) + options = {} + + // base-matching: just use globstar for that. + if (options.matchBase && -1 === pattern.indexOf("/")) { + if (options.noglobstar) { + throw new Error("base matching requires globstar") + } + pattern = "**/" + pattern + } + + self.silent = !!options.silent + self.pattern = pattern + self.strict = options.strict !== false + self.realpath = !!options.realpath + self.realpathCache = options.realpathCache || Object.create(null) + self.follow = !!options.follow + self.dot = !!options.dot + self.mark = !!options.mark + self.nodir = !!options.nodir + if (self.nodir) + self.mark = true + self.sync = !!options.sync + self.nounique = !!options.nounique + self.nonull = !!options.nonull + self.nosort = !!options.nosort + self.nocase = !!options.nocase + self.stat = !!options.stat + self.noprocess = !!options.noprocess + + self.maxLength = options.maxLength || Infinity + self.cache = options.cache || Object.create(null) + self.statCache = options.statCache || Object.create(null) + self.symlinks = options.symlinks || Object.create(null) + + setupIgnores(self, options) + + self.changedCwd = false + var cwd = process.cwd() + if (!ownProp(options, "cwd")) + self.cwd = cwd + else { + self.cwd = options.cwd + self.changedCwd = path.resolve(options.cwd) !== cwd + } + + self.root = options.root || path.resolve(self.cwd, "/") + self.root = path.resolve(self.root) + if (process.platform === "win32") + self.root = self.root.replace(/\\/g, "/") + + self.nomount = !!options.nomount + + // disable comments and negation unless the user explicitly + // passes in false as the option. + options.nonegate = options.nonegate === false ? false : true + options.nocomment = options.nocomment === false ? false : true + deprecationWarning(options) + + self.minimatch = new Minimatch(pattern, options) + self.options = self.minimatch.options +} + +// TODO(isaacs): remove entirely in v6 +// exported to reset in tests +exports.deprecationWarned +function deprecationWarning(options) { + if (!options.nonegate || !options.nocomment) { + if (process.noDeprecation !== true && !exports.deprecationWarned) { + var msg = 'glob WARNING: comments and negation will be disabled in v6' + if (process.throwDeprecation) + throw new Error(msg) + else if (process.traceDeprecation) + console.trace(msg) + else + console.error(msg) + + exports.deprecationWarned = true + } + } +} + +function finish (self) { + var nou = self.nounique + var all = nou ? [] : Object.create(null) + + for (var i = 0, l = self.matches.length; i < l; i ++) { + var matches = self.matches[i] + if (!matches || Object.keys(matches).length === 0) { + if (self.nonull) { + // do like the shell, and spit out the literal glob + var literal = self.minimatch.globSet[i] + if (nou) + all.push(literal) + else + all[literal] = true + } + } else { + // had matches + var m = Object.keys(matches) + if (nou) + all.push.apply(all, m) + else + m.forEach(function (m) { + all[m] = true + }) + } + } + + if (!nou) + all = Object.keys(all) + + if (!self.nosort) + all = all.sort(self.nocase ? alphasorti : alphasort) + + // at *some* point we statted all of these + if (self.mark) { + for (var i = 0; i < all.length; i++) { + all[i] = self._mark(all[i]) + } + if (self.nodir) { + all = all.filter(function (e) { + return !(/\/$/.test(e)) + }) + } + } + + if (self.ignore.length) + all = all.filter(function(m) { + return !isIgnored(self, m) + }) + + self.found = all +} + +function mark (self, p) { + var abs = makeAbs(self, p) + var c = self.cache[abs] + var m = p + if (c) { + var isDir = c === 'DIR' || Array.isArray(c) + var slash = p.slice(-1) === '/' + + if (isDir && !slash) + m += '/' + else if (!isDir && slash) + m = m.slice(0, -1) + + if (m !== p) { + var mabs = makeAbs(self, m) + self.statCache[mabs] = self.statCache[abs] + self.cache[mabs] = self.cache[abs] + } + } + + return m +} + +// lotta situps... +function makeAbs (self, f) { + var abs = f + if (f.charAt(0) === '/') { + abs = path.join(self.root, f) + } else if (isAbsolute(f) || f === '') { + abs = f + } else if (self.changedCwd) { + abs = path.resolve(self.cwd, f) + } else { + abs = path.resolve(f) + } + return abs +} + + +// Return true, if pattern ends with globstar '**', for the accompanying parent directory. +// Ex:- If node_modules/** is the pattern, add 'node_modules' to ignore list along with it's contents +function isIgnored (self, path) { + if (!self.ignore.length) + return false + + return self.ignore.some(function(item) { + return item.matcher.match(path) || !!(item.gmatcher && item.gmatcher.match(path)) + }) +} + +function childrenIgnored (self, path) { + if (!self.ignore.length) + return false + + return self.ignore.some(function(item) { + return !!(item.gmatcher && item.gmatcher.match(path)) + }) +} + +}).call(this,require('_process')) +},{"_process":24,"minimatch":20,"path":22,"path-is-absolute":23}],16:[function(require,module,exports){ +(function (process){ +// Approach: +// +// 1. Get the minimatch set +// 2. For each pattern in the set, PROCESS(pattern, false) +// 3. Store matches per-set, then uniq them +// +// PROCESS(pattern, inGlobStar) +// Get the first [n] items from pattern that are all strings +// Join these together. This is PREFIX. +// If there is no more remaining, then stat(PREFIX) and +// add to matches if it succeeds. END. +// +// If inGlobStar and PREFIX is symlink and points to dir +// set ENTRIES = [] +// else readdir(PREFIX) as ENTRIES +// If fail, END +// +// with ENTRIES +// If pattern[n] is GLOBSTAR +// // handle the case where the globstar match is empty +// // by pruning it out, and testing the resulting pattern +// PROCESS(pattern[0..n] + pattern[n+1 .. $], false) +// // handle other cases. +// for ENTRY in ENTRIES (not dotfiles) +// // attach globstar + tail onto the entry +// // Mark that this entry is a globstar match +// PROCESS(pattern[0..n] + ENTRY + pattern[n .. $], true) +// +// else // not globstar +// for ENTRY in ENTRIES (not dotfiles, unless pattern[n] is dot) +// Test ENTRY against pattern[n] +// If fails, continue +// If passes, PROCESS(pattern[0..n] + item + pattern[n+1 .. $]) +// +// Caveat: +// Cache all stats and readdirs results to minimize syscall. Since all +// we ever care about is existence and directory-ness, we can just keep +// `true` for files, and [children,...] for directories, or `false` for +// things that don't exist. + +module.exports = glob + +var fs = require('fs') +var minimatch = require('minimatch') +var Minimatch = minimatch.Minimatch +var inherits = require('inherits') +var EE = require('events').EventEmitter +var path = require('path') +var assert = require('assert') +var isAbsolute = require('path-is-absolute') +var globSync = require('./sync.js') +var common = require('./common.js') +var alphasort = common.alphasort +var alphasorti = common.alphasorti +var setopts = common.setopts +var ownProp = common.ownProp +var inflight = require('inflight') +var util = require('util') +var childrenIgnored = common.childrenIgnored +var isIgnored = common.isIgnored + +var once = require('once') + +function glob (pattern, options, cb) { + if (typeof options === 'function') cb = options, options = {} + if (!options) options = {} + + if (options.sync) { + if (cb) + throw new TypeError('callback provided to sync glob') + return globSync(pattern, options) + } + + return new Glob(pattern, options, cb) +} + +glob.sync = globSync +var GlobSync = glob.GlobSync = globSync.GlobSync + +// old api surface +glob.glob = glob + +glob.hasMagic = function (pattern, options_) { + var options = util._extend({}, options_) + options.noprocess = true + + var g = new Glob(pattern, options) + var set = g.minimatch.set + if (set.length > 1) + return true + + for (var j = 0; j < set[0].length; j++) { + if (typeof set[0][j] !== 'string') + return true + } + + return false +} + +glob.Glob = Glob +inherits(Glob, EE) +function Glob (pattern, options, cb) { + if (typeof options === 'function') { + cb = options + options = null + } + + if (options && options.sync) { + if (cb) + throw new TypeError('callback provided to sync glob') + return new GlobSync(pattern, options) + } + + if (!(this instanceof Glob)) + return new Glob(pattern, options, cb) + + setopts(this, pattern, options) + this._didRealPath = false + + // process each pattern in the minimatch set + var n = this.minimatch.set.length + + // The matches are stored as {: true,...} so that + // duplicates are automagically pruned. + // Later, we do an Object.keys() on these. + // Keep them as a list so we can fill in when nonull is set. + this.matches = new Array(n) + + if (typeof cb === 'function') { + cb = once(cb) + this.on('error', cb) + this.on('end', function (matches) { + cb(null, matches) + }) + } + + var self = this + var n = this.minimatch.set.length + this._processing = 0 + this.matches = new Array(n) + + this._emitQueue = [] + this._processQueue = [] + this.paused = false + + if (this.noprocess) + return this + + if (n === 0) + return done() + + for (var i = 0; i < n; i ++) { + this._process(this.minimatch.set[i], i, false, done) + } + + function done () { + --self._processing + if (self._processing <= 0) + self._finish() + } +} + +Glob.prototype._finish = function () { + assert(this instanceof Glob) + if (this.aborted) + return + + if (this.realpath && !this._didRealpath) + return this._realpath() + + common.finish(this) + this.emit('end', this.found) +} + +Glob.prototype._realpath = function () { + if (this._didRealpath) + return + + this._didRealpath = true + + var n = this.matches.length + if (n === 0) + return this._finish() + + var self = this + for (var i = 0; i < this.matches.length; i++) + this._realpathSet(i, next) + + function next () { + if (--n === 0) + self._finish() + } +} + +Glob.prototype._realpathSet = function (index, cb) { + var matchset = this.matches[index] + if (!matchset) + return cb() + + var found = Object.keys(matchset) + var self = this + var n = found.length + + if (n === 0) + return cb() + + var set = this.matches[index] = Object.create(null) + found.forEach(function (p, i) { + // If there's a problem with the stat, then it means that + // one or more of the links in the realpath couldn't be + // resolved. just return the abs value in that case. + p = self._makeAbs(p) + fs.realpath(p, self.realpathCache, function (er, real) { + if (!er) + set[real] = true + else if (er.syscall === 'stat') + set[p] = true + else + self.emit('error', er) // srsly wtf right here + + if (--n === 0) { + self.matches[index] = set + cb() + } + }) + }) +} + +Glob.prototype._mark = function (p) { + return common.mark(this, p) +} + +Glob.prototype._makeAbs = function (f) { + return common.makeAbs(this, f) +} + +Glob.prototype.abort = function () { + this.aborted = true + this.emit('abort') +} + +Glob.prototype.pause = function () { + if (!this.paused) { + this.paused = true + this.emit('pause') + } +} + +Glob.prototype.resume = function () { + if (this.paused) { + this.emit('resume') + this.paused = false + if (this._emitQueue.length) { + var eq = this._emitQueue.slice(0) + this._emitQueue.length = 0 + for (var i = 0; i < eq.length; i ++) { + var e = eq[i] + this._emitMatch(e[0], e[1]) + } + } + if (this._processQueue.length) { + var pq = this._processQueue.slice(0) + this._processQueue.length = 0 + for (var i = 0; i < pq.length; i ++) { + var p = pq[i] + this._processing-- + this._process(p[0], p[1], p[2], p[3]) + } + } + } +} + +Glob.prototype._process = function (pattern, index, inGlobStar, cb) { + assert(this instanceof Glob) + assert(typeof cb === 'function') + + if (this.aborted) + return + + this._processing++ + if (this.paused) { + this._processQueue.push([pattern, index, inGlobStar, cb]) + return + } + + //console.error('PROCESS %d', this._processing, pattern) + + // Get the first [n] parts of pattern that are all strings. + var n = 0 + while (typeof pattern[n] === 'string') { + n ++ + } + // now n is the index of the first one that is *not* a string. + + // see if there's anything else + var prefix + switch (n) { + // if not, then this is rather simple + case pattern.length: + this._processSimple(pattern.join('/'), index, cb) + return + + case 0: + // pattern *starts* with some non-trivial item. + // going to readdir(cwd), but not include the prefix in matches. + prefix = null + break + + default: + // pattern has some string bits in the front. + // whatever it starts with, whether that's 'absolute' like /foo/bar, + // or 'relative' like '../baz' + prefix = pattern.slice(0, n).join('/') + break + } + + var remain = pattern.slice(n) + + // get the list of entries. + var read + if (prefix === null) + read = '.' + else if (isAbsolute(prefix) || isAbsolute(pattern.join('/'))) { + if (!prefix || !isAbsolute(prefix)) + prefix = '/' + prefix + read = prefix + } else + read = prefix + + var abs = this._makeAbs(read) + + //if ignored, skip _processing + if (childrenIgnored(this, read)) + return cb() + + var isGlobStar = remain[0] === minimatch.GLOBSTAR + if (isGlobStar) + this._processGlobStar(prefix, read, abs, remain, index, inGlobStar, cb) + else + this._processReaddir(prefix, read, abs, remain, index, inGlobStar, cb) +} + +Glob.prototype._processReaddir = function (prefix, read, abs, remain, index, inGlobStar, cb) { + var self = this + this._readdir(abs, inGlobStar, function (er, entries) { + return self._processReaddir2(prefix, read, abs, remain, index, inGlobStar, entries, cb) + }) +} + +Glob.prototype._processReaddir2 = function (prefix, read, abs, remain, index, inGlobStar, entries, cb) { + + // if the abs isn't a dir, then nothing can match! + if (!entries) + return cb() + + // It will only match dot entries if it starts with a dot, or if + // dot is set. Stuff like @(.foo|.bar) isn't allowed. + var pn = remain[0] + var negate = !!this.minimatch.negate + var rawGlob = pn._glob + var dotOk = this.dot || rawGlob.charAt(0) === '.' + + var matchedEntries = [] + for (var i = 0; i < entries.length; i++) { + var e = entries[i] + if (e.charAt(0) !== '.' || dotOk) { + var m + if (negate && !prefix) { + m = !e.match(pn) + } else { + m = e.match(pn) + } + if (m) + matchedEntries.push(e) + } + } + + //console.error('prd2', prefix, entries, remain[0]._glob, matchedEntries) + + var len = matchedEntries.length + // If there are no matched entries, then nothing matches. + if (len === 0) + return cb() + + // if this is the last remaining pattern bit, then no need for + // an additional stat *unless* the user has specified mark or + // stat explicitly. We know they exist, since readdir returned + // them. + + if (remain.length === 1 && !this.mark && !this.stat) { + if (!this.matches[index]) + this.matches[index] = Object.create(null) + + for (var i = 0; i < len; i ++) { + var e = matchedEntries[i] + if (prefix) { + if (prefix !== '/') + e = prefix + '/' + e + else + e = prefix + e + } + + if (e.charAt(0) === '/' && !this.nomount) { + e = path.join(this.root, e) + } + this._emitMatch(index, e) + } + // This was the last one, and no stats were needed + return cb() + } + + // now test all matched entries as stand-ins for that part + // of the pattern. + remain.shift() + for (var i = 0; i < len; i ++) { + var e = matchedEntries[i] + var newPattern + if (prefix) { + if (prefix !== '/') + e = prefix + '/' + e + else + e = prefix + e + } + this._process([e].concat(remain), index, inGlobStar, cb) + } + cb() +} + +Glob.prototype._emitMatch = function (index, e) { + if (this.aborted) + return + + if (this.matches[index][e]) + return + + if (isIgnored(this, e)) + return + + if (this.paused) { + this._emitQueue.push([index, e]) + return + } + + var abs = this._makeAbs(e) + + if (this.nodir) { + var c = this.cache[abs] + if (c === 'DIR' || Array.isArray(c)) + return + } + + if (this.mark) + e = this._mark(e) + + this.matches[index][e] = true + + var st = this.statCache[abs] + if (st) + this.emit('stat', e, st) + + this.emit('match', e) +} + +Glob.prototype._readdirInGlobStar = function (abs, cb) { + if (this.aborted) + return + + // follow all symlinked directories forever + // just proceed as if this is a non-globstar situation + if (this.follow) + return this._readdir(abs, false, cb) + + var lstatkey = 'lstat\0' + abs + var self = this + var lstatcb = inflight(lstatkey, lstatcb_) + + if (lstatcb) + fs.lstat(abs, lstatcb) + + function lstatcb_ (er, lstat) { + if (er) + return cb() + + var isSym = lstat.isSymbolicLink() + self.symlinks[abs] = isSym + + // If it's not a symlink or a dir, then it's definitely a regular file. + // don't bother doing a readdir in that case. + if (!isSym && !lstat.isDirectory()) { + self.cache[abs] = 'FILE' + cb() + } else + self._readdir(abs, false, cb) + } +} + +Glob.prototype._readdir = function (abs, inGlobStar, cb) { + if (this.aborted) + return + + cb = inflight('readdir\0'+abs+'\0'+inGlobStar, cb) + if (!cb) + return + + //console.error('RD %j %j', +inGlobStar, abs) + if (inGlobStar && !ownProp(this.symlinks, abs)) + return this._readdirInGlobStar(abs, cb) + + if (ownProp(this.cache, abs)) { + var c = this.cache[abs] + if (!c || c === 'FILE') + return cb() + + if (Array.isArray(c)) + return cb(null, c) + } + + var self = this + fs.readdir(abs, readdirCb(this, abs, cb)) +} + +function readdirCb (self, abs, cb) { + return function (er, entries) { + if (er) + self._readdirError(abs, er, cb) + else + self._readdirEntries(abs, entries, cb) + } +} + +Glob.prototype._readdirEntries = function (abs, entries, cb) { + if (this.aborted) + return + + // if we haven't asked to stat everything, then just + // assume that everything in there exists, so we can avoid + // having to stat it a second time. + if (!this.mark && !this.stat) { + for (var i = 0; i < entries.length; i ++) { + var e = entries[i] + if (abs === '/') + e = abs + e + else + e = abs + '/' + e + this.cache[e] = true + } + } + + this.cache[abs] = entries + return cb(null, entries) +} + +Glob.prototype._readdirError = function (f, er, cb) { + if (this.aborted) + return + + // handle errors, and cache the information + switch (er.code) { + case 'ENOTSUP': // https://github.com/isaacs/node-glob/issues/205 + case 'ENOTDIR': // totally normal. means it *does* exist. + this.cache[this._makeAbs(f)] = 'FILE' + break + + case 'ENOENT': // not terribly unusual + case 'ELOOP': + case 'ENAMETOOLONG': + case 'UNKNOWN': + this.cache[this._makeAbs(f)] = false + break + + default: // some unusual error. Treat as failure. + this.cache[this._makeAbs(f)] = false + if (this.strict) { + this.emit('error', er) + // If the error is handled, then we abort + // if not, we threw out of here + this.abort() + } + if (!this.silent) + console.error('glob error', er) + break + } + + return cb() +} + +Glob.prototype._processGlobStar = function (prefix, read, abs, remain, index, inGlobStar, cb) { + var self = this + this._readdir(abs, inGlobStar, function (er, entries) { + self._processGlobStar2(prefix, read, abs, remain, index, inGlobStar, entries, cb) + }) +} + + +Glob.prototype._processGlobStar2 = function (prefix, read, abs, remain, index, inGlobStar, entries, cb) { + //console.error('pgs2', prefix, remain[0], entries) + + // no entries means not a dir, so it can never have matches + // foo.txt/** doesn't match foo.txt + if (!entries) + return cb() + + // test without the globstar, and with every child both below + // and replacing the globstar. + var remainWithoutGlobStar = remain.slice(1) + var gspref = prefix ? [ prefix ] : [] + var noGlobStar = gspref.concat(remainWithoutGlobStar) + + // the noGlobStar pattern exits the inGlobStar state + this._process(noGlobStar, index, false, cb) + + var isSym = this.symlinks[abs] + var len = entries.length + + // If it's a symlink, and we're in a globstar, then stop + if (isSym && inGlobStar) + return cb() + + for (var i = 0; i < len; i++) { + var e = entries[i] + if (e.charAt(0) === '.' && !this.dot) + continue + + // these two cases enter the inGlobStar state + var instead = gspref.concat(entries[i], remainWithoutGlobStar) + this._process(instead, index, true, cb) + + var below = gspref.concat(entries[i], remain) + this._process(below, index, true, cb) + } + + cb() +} + +Glob.prototype._processSimple = function (prefix, index, cb) { + // XXX review this. Shouldn't it be doing the mounting etc + // before doing stat? kinda weird? + var self = this + this._stat(prefix, function (er, exists) { + self._processSimple2(prefix, index, er, exists, cb) + }) +} +Glob.prototype._processSimple2 = function (prefix, index, er, exists, cb) { + + //console.error('ps2', prefix, exists) + + if (!this.matches[index]) + this.matches[index] = Object.create(null) + + // If it doesn't exist, then just mark the lack of results + if (!exists) + return cb() + + if (prefix && isAbsolute(prefix) && !this.nomount) { + var trail = /[\/\\]$/.test(prefix) + if (prefix.charAt(0) === '/') { + prefix = path.join(this.root, prefix) + } else { + prefix = path.resolve(this.root, prefix) + if (trail) + prefix += '/' + } + } + + if (process.platform === 'win32') + prefix = prefix.replace(/\\/g, '/') + + // Mark this as a match + this._emitMatch(index, prefix) + cb() +} + +// Returns either 'DIR', 'FILE', or false +Glob.prototype._stat = function (f, cb) { + var abs = this._makeAbs(f) + var needDir = f.slice(-1) === '/' + + if (f.length > this.maxLength) + return cb() + + if (!this.stat && ownProp(this.cache, abs)) { + var c = this.cache[abs] + + if (Array.isArray(c)) + c = 'DIR' + + // It exists, but maybe not how we need it + if (!needDir || c === 'DIR') + return cb(null, c) + + if (needDir && c === 'FILE') + return cb() + + // otherwise we have to stat, because maybe c=true + // if we know it exists, but not what it is. + } + + var exists + var stat = this.statCache[abs] + if (stat !== undefined) { + if (stat === false) + return cb(null, stat) + else { + var type = stat.isDirectory() ? 'DIR' : 'FILE' + if (needDir && type === 'FILE') + return cb() + else + return cb(null, type, stat) + } + } + + var self = this + var statcb = inflight('stat\0' + abs, lstatcb_) + if (statcb) + fs.lstat(abs, statcb) + + function lstatcb_ (er, lstat) { + if (lstat && lstat.isSymbolicLink()) { + // If it's a symlink, then treat it as the target, unless + // the target does not exist, then treat it as a file. + return fs.stat(abs, function (er, stat) { + if (er) + self._stat2(f, abs, null, lstat, cb) + else + self._stat2(f, abs, er, stat, cb) + }) + } else { + self._stat2(f, abs, er, lstat, cb) + } + } +} + +Glob.prototype._stat2 = function (f, abs, er, stat, cb) { + if (er) { + this.statCache[abs] = false + return cb() + } + + var needDir = f.slice(-1) === '/' + this.statCache[abs] = stat + + if (abs.slice(-1) === '/' && !stat.isDirectory()) + return cb(null, false, stat) + + var c = stat.isDirectory() ? 'DIR' : 'FILE' + this.cache[abs] = this.cache[abs] || c + + if (needDir && c !== 'DIR') + return cb() + + return cb(null, c, stat) +} + +}).call(this,require('_process')) +},{"./common.js":15,"./sync.js":17,"_process":24,"assert":9,"events":14,"fs":12,"inflight":18,"inherits":19,"minimatch":20,"once":21,"path":22,"path-is-absolute":23,"util":28}],17:[function(require,module,exports){ +(function (process){ +module.exports = globSync +globSync.GlobSync = GlobSync + +var fs = require('fs') +var minimatch = require('minimatch') +var Minimatch = minimatch.Minimatch +var Glob = require('./glob.js').Glob +var util = require('util') +var path = require('path') +var assert = require('assert') +var isAbsolute = require('path-is-absolute') +var common = require('./common.js') +var alphasort = common.alphasort +var alphasorti = common.alphasorti +var setopts = common.setopts +var ownProp = common.ownProp +var childrenIgnored = common.childrenIgnored + +function globSync (pattern, options) { + if (typeof options === 'function' || arguments.length === 3) + throw new TypeError('callback provided to sync glob\n'+ + 'See: https://github.com/isaacs/node-glob/issues/167') + + return new GlobSync(pattern, options).found +} + +function GlobSync (pattern, options) { + if (!pattern) + throw new Error('must provide pattern') + + if (typeof options === 'function' || arguments.length === 3) + throw new TypeError('callback provided to sync glob\n'+ + 'See: https://github.com/isaacs/node-glob/issues/167') + + if (!(this instanceof GlobSync)) + return new GlobSync(pattern, options) + + setopts(this, pattern, options) + + if (this.noprocess) + return this + + var n = this.minimatch.set.length + this.matches = new Array(n) + for (var i = 0; i < n; i ++) { + this._process(this.minimatch.set[i], i, false) + } + this._finish() +} + +GlobSync.prototype._finish = function () { + assert(this instanceof GlobSync) + if (this.realpath) { + var self = this + this.matches.forEach(function (matchset, index) { + var set = self.matches[index] = Object.create(null) + for (var p in matchset) { + try { + p = self._makeAbs(p) + var real = fs.realpathSync(p, self.realpathCache) + set[real] = true + } catch (er) { + if (er.syscall === 'stat') + set[self._makeAbs(p)] = true + else + throw er + } + } + }) + } + common.finish(this) +} + + +GlobSync.prototype._process = function (pattern, index, inGlobStar) { + assert(this instanceof GlobSync) + + // Get the first [n] parts of pattern that are all strings. + var n = 0 + while (typeof pattern[n] === 'string') { + n ++ + } + // now n is the index of the first one that is *not* a string. + + // See if there's anything else + var prefix + switch (n) { + // if not, then this is rather simple + case pattern.length: + this._processSimple(pattern.join('/'), index) + return + + case 0: + // pattern *starts* with some non-trivial item. + // going to readdir(cwd), but not include the prefix in matches. + prefix = null + break + + default: + // pattern has some string bits in the front. + // whatever it starts with, whether that's 'absolute' like /foo/bar, + // or 'relative' like '../baz' + prefix = pattern.slice(0, n).join('/') + break + } + + var remain = pattern.slice(n) + + // get the list of entries. + var read + if (prefix === null) + read = '.' + else if (isAbsolute(prefix) || isAbsolute(pattern.join('/'))) { + if (!prefix || !isAbsolute(prefix)) + prefix = '/' + prefix + read = prefix + } else + read = prefix + + var abs = this._makeAbs(read) + + //if ignored, skip processing + if (childrenIgnored(this, read)) + return + + var isGlobStar = remain[0] === minimatch.GLOBSTAR + if (isGlobStar) + this._processGlobStar(prefix, read, abs, remain, index, inGlobStar) + else + this._processReaddir(prefix, read, abs, remain, index, inGlobStar) +} + + +GlobSync.prototype._processReaddir = function (prefix, read, abs, remain, index, inGlobStar) { + var entries = this._readdir(abs, inGlobStar) + + // if the abs isn't a dir, then nothing can match! + if (!entries) + return + + // It will only match dot entries if it starts with a dot, or if + // dot is set. Stuff like @(.foo|.bar) isn't allowed. + var pn = remain[0] + var negate = !!this.minimatch.negate + var rawGlob = pn._glob + var dotOk = this.dot || rawGlob.charAt(0) === '.' + + var matchedEntries = [] + for (var i = 0; i < entries.length; i++) { + var e = entries[i] + if (e.charAt(0) !== '.' || dotOk) { + var m + if (negate && !prefix) { + m = !e.match(pn) + } else { + m = e.match(pn) + } + if (m) + matchedEntries.push(e) + } + } + + var len = matchedEntries.length + // If there are no matched entries, then nothing matches. + if (len === 0) + return + + // if this is the last remaining pattern bit, then no need for + // an additional stat *unless* the user has specified mark or + // stat explicitly. We know they exist, since readdir returned + // them. + + if (remain.length === 1 && !this.mark && !this.stat) { + if (!this.matches[index]) + this.matches[index] = Object.create(null) + + for (var i = 0; i < len; i ++) { + var e = matchedEntries[i] + if (prefix) { + if (prefix.slice(-1) !== '/') + e = prefix + '/' + e + else + e = prefix + e + } + + if (e.charAt(0) === '/' && !this.nomount) { + e = path.join(this.root, e) + } + this.matches[index][e] = true + } + // This was the last one, and no stats were needed + return + } + + // now test all matched entries as stand-ins for that part + // of the pattern. + remain.shift() + for (var i = 0; i < len; i ++) { + var e = matchedEntries[i] + var newPattern + if (prefix) + newPattern = [prefix, e] + else + newPattern = [e] + this._process(newPattern.concat(remain), index, inGlobStar) + } +} + + +GlobSync.prototype._emitMatch = function (index, e) { + var abs = this._makeAbs(e) + if (this.mark) + e = this._mark(e) + + if (this.matches[index][e]) + return + + if (this.nodir) { + var c = this.cache[this._makeAbs(e)] + if (c === 'DIR' || Array.isArray(c)) + return + } + + this.matches[index][e] = true + if (this.stat) + this._stat(e) +} + + +GlobSync.prototype._readdirInGlobStar = function (abs) { + // follow all symlinked directories forever + // just proceed as if this is a non-globstar situation + if (this.follow) + return this._readdir(abs, false) + + var entries + var lstat + var stat + try { + lstat = fs.lstatSync(abs) + } catch (er) { + // lstat failed, doesn't exist + return null + } + + var isSym = lstat.isSymbolicLink() + this.symlinks[abs] = isSym + + // If it's not a symlink or a dir, then it's definitely a regular file. + // don't bother doing a readdir in that case. + if (!isSym && !lstat.isDirectory()) + this.cache[abs] = 'FILE' + else + entries = this._readdir(abs, false) + + return entries +} + +GlobSync.prototype._readdir = function (abs, inGlobStar) { + var entries + + if (inGlobStar && !ownProp(this.symlinks, abs)) + return this._readdirInGlobStar(abs) + + if (ownProp(this.cache, abs)) { + var c = this.cache[abs] + if (!c || c === 'FILE') + return null + + if (Array.isArray(c)) + return c + } + + try { + return this._readdirEntries(abs, fs.readdirSync(abs)) + } catch (er) { + this._readdirError(abs, er) + return null + } +} + +GlobSync.prototype._readdirEntries = function (abs, entries) { + // if we haven't asked to stat everything, then just + // assume that everything in there exists, so we can avoid + // having to stat it a second time. + if (!this.mark && !this.stat) { + for (var i = 0; i < entries.length; i ++) { + var e = entries[i] + if (abs === '/') + e = abs + e + else + e = abs + '/' + e + this.cache[e] = true + } + } + + this.cache[abs] = entries + + // mark and cache dir-ness + return entries +} + +GlobSync.prototype._readdirError = function (f, er) { + // handle errors, and cache the information + switch (er.code) { + case 'ENOTSUP': // https://github.com/isaacs/node-glob/issues/205 + case 'ENOTDIR': // totally normal. means it *does* exist. + this.cache[this._makeAbs(f)] = 'FILE' + break + + case 'ENOENT': // not terribly unusual + case 'ELOOP': + case 'ENAMETOOLONG': + case 'UNKNOWN': + this.cache[this._makeAbs(f)] = false + break + + default: // some unusual error. Treat as failure. + this.cache[this._makeAbs(f)] = false + if (this.strict) + throw er + if (!this.silent) + console.error('glob error', er) + break + } +} + +GlobSync.prototype._processGlobStar = function (prefix, read, abs, remain, index, inGlobStar) { + + var entries = this._readdir(abs, inGlobStar) + + // no entries means not a dir, so it can never have matches + // foo.txt/** doesn't match foo.txt + if (!entries) + return + + // test without the globstar, and with every child both below + // and replacing the globstar. + var remainWithoutGlobStar = remain.slice(1) + var gspref = prefix ? [ prefix ] : [] + var noGlobStar = gspref.concat(remainWithoutGlobStar) + + // the noGlobStar pattern exits the inGlobStar state + this._process(noGlobStar, index, false) + + var len = entries.length + var isSym = this.symlinks[abs] + + // If it's a symlink, and we're in a globstar, then stop + if (isSym && inGlobStar) + return + + for (var i = 0; i < len; i++) { + var e = entries[i] + if (e.charAt(0) === '.' && !this.dot) + continue + + // these two cases enter the inGlobStar state + var instead = gspref.concat(entries[i], remainWithoutGlobStar) + this._process(instead, index, true) + + var below = gspref.concat(entries[i], remain) + this._process(below, index, true) + } +} + +GlobSync.prototype._processSimple = function (prefix, index) { + // XXX review this. Shouldn't it be doing the mounting etc + // before doing stat? kinda weird? + var exists = this._stat(prefix) + + if (!this.matches[index]) + this.matches[index] = Object.create(null) + + // If it doesn't exist, then just mark the lack of results + if (!exists) + return + + if (prefix && isAbsolute(prefix) && !this.nomount) { + var trail = /[\/\\]$/.test(prefix) + if (prefix.charAt(0) === '/') { + prefix = path.join(this.root, prefix) + } else { + prefix = path.resolve(this.root, prefix) + if (trail) + prefix += '/' + } + } + + if (process.platform === 'win32') + prefix = prefix.replace(/\\/g, '/') + + // Mark this as a match + this.matches[index][prefix] = true +} + +// Returns either 'DIR', 'FILE', or false +GlobSync.prototype._stat = function (f) { + var abs = this._makeAbs(f) + var needDir = f.slice(-1) === '/' + + if (f.length > this.maxLength) + return false + + if (!this.stat && ownProp(this.cache, abs)) { + var c = this.cache[abs] + + if (Array.isArray(c)) + c = 'DIR' + + // It exists, but maybe not how we need it + if (!needDir || c === 'DIR') + return c + + if (needDir && c === 'FILE') + return false + + // otherwise we have to stat, because maybe c=true + // if we know it exists, but not what it is. + } + + var exists + var stat = this.statCache[abs] + if (!stat) { + var lstat + try { + lstat = fs.lstatSync(abs) + } catch (er) { + return false + } + + if (lstat.isSymbolicLink()) { + try { + stat = fs.statSync(abs) + } catch (er) { + stat = lstat + } + } else { + stat = lstat + } + } + + this.statCache[abs] = stat + + var c = stat.isDirectory() ? 'DIR' : 'FILE' + this.cache[abs] = this.cache[abs] || c + + if (needDir && c !== 'DIR') + return false + + return c +} + +GlobSync.prototype._mark = function (p) { + return common.mark(this, p) +} + +GlobSync.prototype._makeAbs = function (f) { + return common.makeAbs(this, f) +} + +}).call(this,require('_process')) +},{"./common.js":15,"./glob.js":16,"_process":24,"assert":9,"fs":12,"minimatch":20,"path":22,"path-is-absolute":23,"util":28}],18:[function(require,module,exports){ +(function (process){ +var wrappy = require('wrappy') +var reqs = Object.create(null) +var once = require('once') + +module.exports = wrappy(inflight) + +function inflight (key, cb) { + if (reqs[key]) { + reqs[key].push(cb) + return null + } else { + reqs[key] = [cb] + return makeres(key) + } +} + +function makeres (key) { + return once(function RES () { + var cbs = reqs[key] + var len = cbs.length + var args = slice(arguments) + + // XXX It's somewhat ambiguous whether a new callback added in this + // pass should be queued for later execution if something in the + // list of callbacks throws, or if it should just be discarded. + // However, it's such an edge case that it hardly matters, and either + // choice is likely as surprising as the other. + // As it happens, we do go ahead and schedule it for later execution. + try { + for (var i = 0; i < len; i++) { + cbs[i].apply(null, args) + } + } finally { + if (cbs.length > len) { + // added more in the interim. + // de-zalgo, just in case, but don't call again. + cbs.splice(0, len) + process.nextTick(function () { + RES.apply(null, args) + }) + } else { + delete reqs[key] + } + } + }) +} + +function slice (args) { + var length = args.length + var array = [] + + for (var i = 0; i < length; i++) array[i] = args[i] + return array +} + +}).call(this,require('_process')) +},{"_process":24,"once":21,"wrappy":29}],19:[function(require,module,exports){ +if (typeof Object.create === 'function') { + // implementation from standard node.js 'util' module + module.exports = function inherits(ctor, superCtor) { + ctor.super_ = superCtor + ctor.prototype = Object.create(superCtor.prototype, { + constructor: { + value: ctor, + enumerable: false, + writable: true, + configurable: true + } + }); + }; +} else { + // old school shim for old browsers + module.exports = function inherits(ctor, superCtor) { + ctor.super_ = superCtor + var TempCtor = function () {} + TempCtor.prototype = superCtor.prototype + ctor.prototype = new TempCtor() + ctor.prototype.constructor = ctor + } +} + +},{}],20:[function(require,module,exports){ +module.exports = minimatch +minimatch.Minimatch = Minimatch + +var path = { sep: '/' } +try { + path = require('path') +} catch (er) {} + +var GLOBSTAR = minimatch.GLOBSTAR = Minimatch.GLOBSTAR = {} +var expand = require('brace-expansion') + +var plTypes = { + '!': { open: '(?:(?!(?:', close: '))[^/]*?)'}, + '?': { open: '(?:', close: ')?' }, + '+': { open: '(?:', close: ')+' }, + '*': { open: '(?:', close: ')*' }, + '@': { open: '(?:', close: ')' } +} + +// any single thing other than / +// don't need to escape / when using new RegExp() +var qmark = '[^/]' + +// * => any number of characters +var star = qmark + '*?' + +// ** when dots are allowed. Anything goes, except .. and . +// not (^ or / followed by one or two dots followed by $ or /), +// followed by anything, any number of times. +var twoStarDot = '(?:(?!(?:\\\/|^)(?:\\.{1,2})($|\\\/)).)*?' + +// not a ^ or / followed by a dot, +// followed by anything, any number of times. +var twoStarNoDot = '(?:(?!(?:\\\/|^)\\.).)*?' + +// characters that need to be escaped in RegExp. +var reSpecials = charSet('().*{}+?[]^$\\!') + +// "abc" -> { a:true, b:true, c:true } +function charSet (s) { + return s.split('').reduce(function (set, c) { + set[c] = true + return set + }, {}) +} + +// normalizes slashes. +var slashSplit = /\/+/ + +minimatch.filter = filter +function filter (pattern, options) { + options = options || {} + return function (p, i, list) { + return minimatch(p, pattern, options) + } +} + +function ext (a, b) { + a = a || {} + b = b || {} + var t = {} + Object.keys(b).forEach(function (k) { + t[k] = b[k] + }) + Object.keys(a).forEach(function (k) { + t[k] = a[k] + }) + return t +} + +minimatch.defaults = function (def) { + if (!def || !Object.keys(def).length) return minimatch + + var orig = minimatch + + var m = function minimatch (p, pattern, options) { + return orig.minimatch(p, pattern, ext(def, options)) + } + + m.Minimatch = function Minimatch (pattern, options) { + return new orig.Minimatch(pattern, ext(def, options)) + } + + return m +} + +Minimatch.defaults = function (def) { + if (!def || !Object.keys(def).length) return Minimatch + return minimatch.defaults(def).Minimatch +} + +function minimatch (p, pattern, options) { + if (typeof pattern !== 'string') { + throw new TypeError('glob pattern string required') + } + + if (!options) options = {} + + // shortcut: comments match nothing. + if (!options.nocomment && pattern.charAt(0) === '#') { + return false + } + + // "" only matches "" + if (pattern.trim() === '') return p === '' + + return new Minimatch(pattern, options).match(p) +} + +function Minimatch (pattern, options) { + if (!(this instanceof Minimatch)) { + return new Minimatch(pattern, options) + } + + if (typeof pattern !== 'string') { + throw new TypeError('glob pattern string required') + } + + if (!options) options = {} + pattern = pattern.trim() + + // windows support: need to use /, not \ + if (path.sep !== '/') { + pattern = pattern.split(path.sep).join('/') + } + + this.options = options + this.set = [] + this.pattern = pattern + this.regexp = null + this.negate = false + this.comment = false + this.empty = false + + // make the set of regexps etc. + this.make() +} + +Minimatch.prototype.debug = function () {} + +Minimatch.prototype.make = make +function make () { + // don't do it more than once. + if (this._made) return + + var pattern = this.pattern + var options = this.options + + // empty patterns and comments match nothing. + if (!options.nocomment && pattern.charAt(0) === '#') { + this.comment = true + return + } + if (!pattern) { + this.empty = true + return + } + + // step 1: figure out negation, etc. + this.parseNegate() + + // step 2: expand braces + var set = this.globSet = this.braceExpand() + + if (options.debug) this.debug = console.error + + this.debug(this.pattern, set) + + // step 3: now we have a set, so turn each one into a series of path-portion + // matching patterns. + // These will be regexps, except in the case of "**", which is + // set to the GLOBSTAR object for globstar behavior, + // and will not contain any / characters + set = this.globParts = set.map(function (s) { + return s.split(slashSplit) + }) + + this.debug(this.pattern, set) + + // glob --> regexps + set = set.map(function (s, si, set) { + return s.map(this.parse, this) + }, this) + + this.debug(this.pattern, set) + + // filter out everything that didn't compile properly. + set = set.filter(function (s) { + return s.indexOf(false) === -1 + }) + + this.debug(this.pattern, set) + + this.set = set +} + +Minimatch.prototype.parseNegate = parseNegate +function parseNegate () { + var pattern = this.pattern + var negate = false + var options = this.options + var negateOffset = 0 + + if (options.nonegate) return + + for (var i = 0, l = pattern.length + ; i < l && pattern.charAt(i) === '!' + ; i++) { + negate = !negate + negateOffset++ + } + + if (negateOffset) this.pattern = pattern.substr(negateOffset) + this.negate = negate +} + +// Brace expansion: +// a{b,c}d -> abd acd +// a{b,}c -> abc ac +// a{0..3}d -> a0d a1d a2d a3d +// a{b,c{d,e}f}g -> abg acdfg acefg +// a{b,c}d{e,f}g -> abdeg acdeg abdeg abdfg +// +// Invalid sets are not expanded. +// a{2..}b -> a{2..}b +// a{b}c -> a{b}c +minimatch.braceExpand = function (pattern, options) { + return braceExpand(pattern, options) +} + +Minimatch.prototype.braceExpand = braceExpand + +function braceExpand (pattern, options) { + if (!options) { + if (this instanceof Minimatch) { + options = this.options + } else { + options = {} + } + } + + pattern = typeof pattern === 'undefined' + ? this.pattern : pattern + + if (typeof pattern === 'undefined') { + throw new TypeError('undefined pattern') + } + + if (options.nobrace || + !pattern.match(/\{.*\}/)) { + // shortcut. no need to expand. + return [pattern] + } + + return expand(pattern) +} + +// parse a component of the expanded set. +// At this point, no pattern may contain "/" in it +// so we're going to return a 2d array, where each entry is the full +// pattern, split on '/', and then turned into a regular expression. +// A regexp is made at the end which joins each array with an +// escaped /, and another full one which joins each regexp with |. +// +// Following the lead of Bash 4.1, note that "**" only has special meaning +// when it is the *only* thing in a path portion. Otherwise, any series +// of * is equivalent to a single *. Globstar behavior is enabled by +// default, and can be disabled by setting options.noglobstar. +Minimatch.prototype.parse = parse +var SUBPARSE = {} +function parse (pattern, isSub) { + if (pattern.length > 1024 * 64) { + throw new TypeError('pattern is too long') + } + + var options = this.options + + // shortcuts + if (!options.noglobstar && pattern === '**') return GLOBSTAR + if (pattern === '') return '' + + var re = '' + var hasMagic = !!options.nocase + var escaping = false + // ? => one single character + var patternListStack = [] + var negativeLists = [] + var stateChar + var inClass = false + var reClassStart = -1 + var classStart = -1 + // . and .. never match anything that doesn't start with ., + // even when options.dot is set. + var patternStart = pattern.charAt(0) === '.' ? '' // anything + // not (start or / followed by . or .. followed by / or end) + : options.dot ? '(?!(?:^|\\\/)\\.{1,2}(?:$|\\\/))' + : '(?!\\.)' + var self = this + + function clearStateChar () { + if (stateChar) { + // we had some state-tracking character + // that wasn't consumed by this pass. + switch (stateChar) { + case '*': + re += star + hasMagic = true + break + case '?': + re += qmark + hasMagic = true + break + default: + re += '\\' + stateChar + break + } + self.debug('clearStateChar %j %j', stateChar, re) + stateChar = false + } + } + + for (var i = 0, len = pattern.length, c + ; (i < len) && (c = pattern.charAt(i)) + ; i++) { + this.debug('%s\t%s %s %j', pattern, i, re, c) + + // skip over any that are escaped. + if (escaping && reSpecials[c]) { + re += '\\' + c + escaping = false + continue + } + + switch (c) { + case '/': + // completely not allowed, even escaped. + // Should already be path-split by now. + return false + + case '\\': + clearStateChar() + escaping = true + continue + + // the various stateChar values + // for the "extglob" stuff. + case '?': + case '*': + case '+': + case '@': + case '!': + this.debug('%s\t%s %s %j <-- stateChar', pattern, i, re, c) + + // all of those are literals inside a class, except that + // the glob [!a] means [^a] in regexp + if (inClass) { + this.debug(' in class') + if (c === '!' && i === classStart + 1) c = '^' + re += c + continue + } + + // if we already have a stateChar, then it means + // that there was something like ** or +? in there. + // Handle the stateChar, then proceed with this one. + self.debug('call clearStateChar %j', stateChar) + clearStateChar() + stateChar = c + // if extglob is disabled, then +(asdf|foo) isn't a thing. + // just clear the statechar *now*, rather than even diving into + // the patternList stuff. + if (options.noext) clearStateChar() + continue + + case '(': + if (inClass) { + re += '(' + continue + } + + if (!stateChar) { + re += '\\(' + continue + } + + patternListStack.push({ + type: stateChar, + start: i - 1, + reStart: re.length, + open: plTypes[stateChar].open, + close: plTypes[stateChar].close + }) + // negation is (?:(?!js)[^/]*) + re += stateChar === '!' ? '(?:(?!(?:' : '(?:' + this.debug('plType %j %j', stateChar, re) + stateChar = false + continue + + case ')': + if (inClass || !patternListStack.length) { + re += '\\)' + continue + } + + clearStateChar() + hasMagic = true + var pl = patternListStack.pop() + // negation is (?:(?!js)[^/]*) + // The others are (?:) + re += pl.close + if (pl.type === '!') { + negativeLists.push(pl) + } + pl.reEnd = re.length + continue + + case '|': + if (inClass || !patternListStack.length || escaping) { + re += '\\|' + escaping = false + continue + } + + clearStateChar() + re += '|' + continue + + // these are mostly the same in regexp and glob + case '[': + // swallow any state-tracking char before the [ + clearStateChar() + + if (inClass) { + re += '\\' + c + continue + } + + inClass = true + classStart = i + reClassStart = re.length + re += c + continue + + case ']': + // a right bracket shall lose its special + // meaning and represent itself in + // a bracket expression if it occurs + // first in the list. -- POSIX.2 2.8.3.2 + if (i === classStart + 1 || !inClass) { + re += '\\' + c + escaping = false + continue + } + + // handle the case where we left a class open. + // "[z-a]" is valid, equivalent to "\[z-a\]" + if (inClass) { + // split where the last [ was, make sure we don't have + // an invalid re. if so, re-walk the contents of the + // would-be class to re-translate any characters that + // were passed through as-is + // TODO: It would probably be faster to determine this + // without a try/catch and a new RegExp, but it's tricky + // to do safely. For now, this is safe and works. + var cs = pattern.substring(classStart + 1, i) + try { + RegExp('[' + cs + ']') + } catch (er) { + // not a valid class! + var sp = this.parse(cs, SUBPARSE) + re = re.substr(0, reClassStart) + '\\[' + sp[0] + '\\]' + hasMagic = hasMagic || sp[1] + inClass = false + continue + } + } + + // finish up the class. + hasMagic = true + inClass = false + re += c + continue + + default: + // swallow any state char that wasn't consumed + clearStateChar() + + if (escaping) { + // no need + escaping = false + } else if (reSpecials[c] + && !(c === '^' && inClass)) { + re += '\\' + } + + re += c + + } // switch + } // for + + // handle the case where we left a class open. + // "[abc" is valid, equivalent to "\[abc" + if (inClass) { + // split where the last [ was, and escape it + // this is a huge pita. We now have to re-walk + // the contents of the would-be class to re-translate + // any characters that were passed through as-is + cs = pattern.substr(classStart + 1) + sp = this.parse(cs, SUBPARSE) + re = re.substr(0, reClassStart) + '\\[' + sp[0] + hasMagic = hasMagic || sp[1] + } + + // handle the case where we had a +( thing at the *end* + // of the pattern. + // each pattern list stack adds 3 chars, and we need to go through + // and escape any | chars that were passed through as-is for the regexp. + // Go through and escape them, taking care not to double-escape any + // | chars that were already escaped. + for (pl = patternListStack.pop(); pl; pl = patternListStack.pop()) { + var tail = re.slice(pl.reStart + pl.open.length) + this.debug('setting tail', re, pl) + // maybe some even number of \, then maybe 1 \, followed by a | + tail = tail.replace(/((?:\\{2}){0,64})(\\?)\|/g, function (_, $1, $2) { + if (!$2) { + // the | isn't already escaped, so escape it. + $2 = '\\' + } + + // need to escape all those slashes *again*, without escaping the + // one that we need for escaping the | character. As it works out, + // escaping an even number of slashes can be done by simply repeating + // it exactly after itself. That's why this trick works. + // + // I am sorry that you have to see this. + return $1 + $1 + $2 + '|' + }) + + this.debug('tail=%j\n %s', tail, tail, pl, re) + var t = pl.type === '*' ? star + : pl.type === '?' ? qmark + : '\\' + pl.type + + hasMagic = true + re = re.slice(0, pl.reStart) + t + '\\(' + tail + } + + // handle trailing things that only matter at the very end. + clearStateChar() + if (escaping) { + // trailing \\ + re += '\\\\' + } + + // only need to apply the nodot start if the re starts with + // something that could conceivably capture a dot + var addPatternStart = false + switch (re.charAt(0)) { + case '.': + case '[': + case '(': addPatternStart = true + } + + // Hack to work around lack of negative lookbehind in JS + // A pattern like: *.!(x).!(y|z) needs to ensure that a name + // like 'a.xyz.yz' doesn't match. So, the first negative + // lookahead, has to look ALL the way ahead, to the end of + // the pattern. + for (var n = negativeLists.length - 1; n > -1; n--) { + var nl = negativeLists[n] + + var nlBefore = re.slice(0, nl.reStart) + var nlFirst = re.slice(nl.reStart, nl.reEnd - 8) + var nlLast = re.slice(nl.reEnd - 8, nl.reEnd) + var nlAfter = re.slice(nl.reEnd) + + nlLast += nlAfter + + // Handle nested stuff like *(*.js|!(*.json)), where open parens + // mean that we should *not* include the ) in the bit that is considered + // "after" the negated section. + var openParensBefore = nlBefore.split('(').length - 1 + var cleanAfter = nlAfter + for (i = 0; i < openParensBefore; i++) { + cleanAfter = cleanAfter.replace(/\)[+*?]?/, '') + } + nlAfter = cleanAfter + + var dollar = '' + if (nlAfter === '' && isSub !== SUBPARSE) { + dollar = '$' + } + var newRe = nlBefore + nlFirst + nlAfter + dollar + nlLast + re = newRe + } + + // if the re is not "" at this point, then we need to make sure + // it doesn't match against an empty path part. + // Otherwise a/* will match a/, which it should not. + if (re !== '' && hasMagic) { + re = '(?=.)' + re + } + + if (addPatternStart) { + re = patternStart + re + } + + // parsing just a piece of a larger pattern. + if (isSub === SUBPARSE) { + return [re, hasMagic] + } + + // skip the regexp for non-magical patterns + // unescape anything in it, though, so that it'll be + // an exact match against a file etc. + if (!hasMagic) { + return globUnescape(pattern) + } + + var flags = options.nocase ? 'i' : '' + try { + var regExp = new RegExp('^' + re + '$', flags) + } catch (er) { + // If it was an invalid regular expression, then it can't match + // anything. This trick looks for a character after the end of + // the string, which is of course impossible, except in multi-line + // mode, but it's not a /m regex. + return new RegExp('$.') + } + + regExp._glob = pattern + regExp._src = re + + return regExp +} + +minimatch.makeRe = function (pattern, options) { + return new Minimatch(pattern, options || {}).makeRe() +} + +Minimatch.prototype.makeRe = makeRe +function makeRe () { + if (this.regexp || this.regexp === false) return this.regexp + + // at this point, this.set is a 2d array of partial + // pattern strings, or "**". + // + // It's better to use .match(). This function shouldn't + // be used, really, but it's pretty convenient sometimes, + // when you just want to work with a regex. + var set = this.set + + if (!set.length) { + this.regexp = false + return this.regexp + } + var options = this.options + + var twoStar = options.noglobstar ? star + : options.dot ? twoStarDot + : twoStarNoDot + var flags = options.nocase ? 'i' : '' + + var re = set.map(function (pattern) { + return pattern.map(function (p) { + return (p === GLOBSTAR) ? twoStar + : (typeof p === 'string') ? regExpEscape(p) + : p._src + }).join('\\\/') + }).join('|') + + // must match entire pattern + // ending in a * or ** will make it less strict. + re = '^(?:' + re + ')$' + + // can match anything, as long as it's not this. + if (this.negate) re = '^(?!' + re + ').*$' + + try { + this.regexp = new RegExp(re, flags) + } catch (ex) { + this.regexp = false + } + return this.regexp +} + +minimatch.match = function (list, pattern, options) { + options = options || {} + var mm = new Minimatch(pattern, options) + list = list.filter(function (f) { + return mm.match(f) + }) + if (mm.options.nonull && !list.length) { + list.push(pattern) + } + return list +} + +Minimatch.prototype.match = match +function match (f, partial) { + this.debug('match', f, this.pattern) + // short-circuit in the case of busted things. + // comments, etc. + if (this.comment) return false + if (this.empty) return f === '' + + if (f === '/' && partial) return true + + var options = this.options + + // windows: need to use /, not \ + if (path.sep !== '/') { + f = f.split(path.sep).join('/') + } + + // treat the test path as a set of pathparts. + f = f.split(slashSplit) + this.debug(this.pattern, 'split', f) + + // just ONE of the pattern sets in this.set needs to match + // in order for it to be valid. If negating, then just one + // match means that we have failed. + // Either way, return on the first hit. + + var set = this.set + this.debug(this.pattern, 'set', set) + + // Find the basename of the path by looking for the last non-empty segment + var filename + var i + for (i = f.length - 1; i >= 0; i--) { + filename = f[i] + if (filename) break + } + + for (i = 0; i < set.length; i++) { + var pattern = set[i] + var file = f + if (options.matchBase && pattern.length === 1) { + file = [filename] + } + var hit = this.matchOne(file, pattern, partial) + if (hit) { + if (options.flipNegate) return true + return !this.negate + } + } + + // didn't get any hits. this is success if it's a negative + // pattern, failure otherwise. + if (options.flipNegate) return false + return this.negate +} + +// set partial to true to test if, for example, +// "/a/b" matches the start of "/*/b/*/d" +// Partial means, if you run out of file before you run +// out of pattern, then that's fine, as long as all +// the parts match. +Minimatch.prototype.matchOne = function (file, pattern, partial) { + var options = this.options + + this.debug('matchOne', + { 'this': this, file: file, pattern: pattern }) + + this.debug('matchOne', file.length, pattern.length) + + for (var fi = 0, + pi = 0, + fl = file.length, + pl = pattern.length + ; (fi < fl) && (pi < pl) + ; fi++, pi++) { + this.debug('matchOne loop') + var p = pattern[pi] + var f = file[fi] + + this.debug(pattern, p, f) + + // should be impossible. + // some invalid regexp stuff in the set. + if (p === false) return false + + if (p === GLOBSTAR) { + this.debug('GLOBSTAR', [pattern, p, f]) + + // "**" + // a/**/b/**/c would match the following: + // a/b/x/y/z/c + // a/x/y/z/b/c + // a/b/x/b/x/c + // a/b/c + // To do this, take the rest of the pattern after + // the **, and see if it would match the file remainder. + // If so, return success. + // If not, the ** "swallows" a segment, and try again. + // This is recursively awful. + // + // a/**/b/**/c matching a/b/x/y/z/c + // - a matches a + // - doublestar + // - matchOne(b/x/y/z/c, b/**/c) + // - b matches b + // - doublestar + // - matchOne(x/y/z/c, c) -> no + // - matchOne(y/z/c, c) -> no + // - matchOne(z/c, c) -> no + // - matchOne(c, c) yes, hit + var fr = fi + var pr = pi + 1 + if (pr === pl) { + this.debug('** at the end') + // a ** at the end will just swallow the rest. + // We have found a match. + // however, it will not swallow /.x, unless + // options.dot is set. + // . and .. are *never* matched by **, for explosively + // exponential reasons. + for (; fi < fl; fi++) { + if (file[fi] === '.' || file[fi] === '..' || + (!options.dot && file[fi].charAt(0) === '.')) return false + } + return true + } + + // ok, let's see if we can swallow whatever we can. + while (fr < fl) { + var swallowee = file[fr] + + this.debug('\nglobstar while', file, fr, pattern, pr, swallowee) + + // XXX remove this slice. Just pass the start index. + if (this.matchOne(file.slice(fr), pattern.slice(pr), partial)) { + this.debug('globstar found match!', fr, fl, swallowee) + // found a match. + return true + } else { + // can't swallow "." or ".." ever. + // can only swallow ".foo" when explicitly asked. + if (swallowee === '.' || swallowee === '..' || + (!options.dot && swallowee.charAt(0) === '.')) { + this.debug('dot detected!', file, fr, pattern, pr) + break + } + + // ** swallows a segment, and continue. + this.debug('globstar swallow a segment, and continue') + fr++ + } + } + + // no match was found. + // However, in partial mode, we can't say this is necessarily over. + // If there's more *pattern* left, then + if (partial) { + // ran out of file + this.debug('\n>>> no match, partial?', file, fr, pattern, pr) + if (fr === fl) return true + } + return false + } + + // something other than ** + // non-magic patterns just have to match exactly + // patterns with magic have been turned into regexps. + var hit + if (typeof p === 'string') { + if (options.nocase) { + hit = f.toLowerCase() === p.toLowerCase() + } else { + hit = f === p + } + this.debug('string match', p, f, hit) + } else { + hit = f.match(p) + this.debug('pattern match', p, f, hit) + } + + if (!hit) return false + } + + // Note: ending in / means that we'll get a final "" + // at the end of the pattern. This can only match a + // corresponding "" at the end of the file. + // If the file ends in /, then it can only match a + // a pattern that ends in /, unless the pattern just + // doesn't have any more for it. But, a/b/ should *not* + // match "a/b/*", even though "" matches against the + // [^/]*? pattern, except in partial mode, where it might + // simply not be reached yet. + // However, a/b/ should still satisfy a/* + + // now either we fell off the end of the pattern, or we're done. + if (fi === fl && pi === pl) { + // ran out of pattern and filename at the same time. + // an exact hit! + return true + } else if (fi === fl) { + // ran out of file, but still had pattern left. + // this is ok if we're doing the match as part of + // a glob fs traversal. + return partial + } else if (pi === pl) { + // ran out of pattern, still have file left. + // this is only acceptable if we're on the very last + // empty segment of a file with a trailing slash. + // a/* should match a/b/ + var emptyFileEnd = (fi === fl - 1) && (file[fi] === '') + return emptyFileEnd + } + + // should be unreachable. + throw new Error('wtf?') +} + +// replace stuff like \* with * +function globUnescape (s) { + return s.replace(/\\(.)/g, '$1') +} + +function regExpEscape (s) { + return s.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&') +} + +},{"brace-expansion":11,"path":22}],21:[function(require,module,exports){ +var wrappy = require('wrappy') +module.exports = wrappy(once) +module.exports.strict = wrappy(onceStrict) + +once.proto = once(function () { + Object.defineProperty(Function.prototype, 'once', { + value: function () { + return once(this) + }, + configurable: true + }) + + Object.defineProperty(Function.prototype, 'onceStrict', { + value: function () { + return onceStrict(this) + }, + configurable: true + }) +}) + +function once (fn) { + var f = function () { + if (f.called) return f.value + f.called = true + return f.value = fn.apply(this, arguments) + } + f.called = false + return f +} + +function onceStrict (fn) { + var f = function () { + if (f.called) + throw new Error(f.onceError) + f.called = true + return f.value = fn.apply(this, arguments) + } + var name = fn.name || 'Function wrapped with `once`' + f.onceError = name + " shouldn't be called more than once" + f.called = false + return f +} + +},{"wrappy":29}],22:[function(require,module,exports){ +(function (process){ +// Copyright Joyent, Inc. and other Node contributors. +// +// Permission is hereby granted, free of charge, to any person obtaining a +// copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to permit +// persons to whom the Software is furnished to do so, subject to the +// following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +// USE OR OTHER DEALINGS IN THE SOFTWARE. + +// resolves . and .. elements in a path array with directory names there +// must be no slashes, empty elements, or device names (c:\) in the array +// (so also no leading and trailing slashes - it does not distinguish +// relative and absolute paths) +function normalizeArray(parts, allowAboveRoot) { + // if the path tries to go above the root, `up` ends up > 0 + var up = 0; + for (var i = parts.length - 1; i >= 0; i--) { + var last = parts[i]; + if (last === '.') { + parts.splice(i, 1); + } else if (last === '..') { + parts.splice(i, 1); + up++; + } else if (up) { + parts.splice(i, 1); + up--; + } + } + + // if the path is allowed to go above the root, restore leading ..s + if (allowAboveRoot) { + for (; up--; up) { + parts.unshift('..'); + } + } + + return parts; +} + +// Split a filename into [root, dir, basename, ext], unix version +// 'root' is just a slash, or nothing. +var splitPathRe = + /^(\/?|)([\s\S]*?)((?:\.{1,2}|[^\/]+?|)(\.[^.\/]*|))(?:[\/]*)$/; +var splitPath = function(filename) { + return splitPathRe.exec(filename).slice(1); +}; + +// path.resolve([from ...], to) +// posix version +exports.resolve = function() { + var resolvedPath = '', + resolvedAbsolute = false; + + for (var i = arguments.length - 1; i >= -1 && !resolvedAbsolute; i--) { + var path = (i >= 0) ? arguments[i] : process.cwd(); + + // Skip empty and invalid entries + if (typeof path !== 'string') { + throw new TypeError('Arguments to path.resolve must be strings'); + } else if (!path) { + continue; + } + + resolvedPath = path + '/' + resolvedPath; + resolvedAbsolute = path.charAt(0) === '/'; + } + + // At this point the path should be resolved to a full absolute path, but + // handle relative paths to be safe (might happen when process.cwd() fails) + + // Normalize the path + resolvedPath = normalizeArray(filter(resolvedPath.split('/'), function(p) { + return !!p; + }), !resolvedAbsolute).join('/'); + + return ((resolvedAbsolute ? '/' : '') + resolvedPath) || '.'; +}; + +// path.normalize(path) +// posix version +exports.normalize = function(path) { + var isAbsolute = exports.isAbsolute(path), + trailingSlash = substr(path, -1) === '/'; + + // Normalize the path + path = normalizeArray(filter(path.split('/'), function(p) { + return !!p; + }), !isAbsolute).join('/'); + + if (!path && !isAbsolute) { + path = '.'; + } + if (path && trailingSlash) { + path += '/'; + } + + return (isAbsolute ? '/' : '') + path; +}; + +// posix version +exports.isAbsolute = function(path) { + return path.charAt(0) === '/'; +}; + +// posix version +exports.join = function() { + var paths = Array.prototype.slice.call(arguments, 0); + return exports.normalize(filter(paths, function(p, index) { + if (typeof p !== 'string') { + throw new TypeError('Arguments to path.join must be strings'); + } + return p; + }).join('/')); +}; + + +// path.relative(from, to) +// posix version +exports.relative = function(from, to) { + from = exports.resolve(from).substr(1); + to = exports.resolve(to).substr(1); + + function trim(arr) { + var start = 0; + for (; start < arr.length; start++) { + if (arr[start] !== '') break; + } + + var end = arr.length - 1; + for (; end >= 0; end--) { + if (arr[end] !== '') break; + } + + if (start > end) return []; + return arr.slice(start, end - start + 1); + } + + var fromParts = trim(from.split('/')); + var toParts = trim(to.split('/')); + + var length = Math.min(fromParts.length, toParts.length); + var samePartsLength = length; + for (var i = 0; i < length; i++) { + if (fromParts[i] !== toParts[i]) { + samePartsLength = i; + break; + } + } + + var outputParts = []; + for (var i = samePartsLength; i < fromParts.length; i++) { + outputParts.push('..'); + } + + outputParts = outputParts.concat(toParts.slice(samePartsLength)); + + return outputParts.join('/'); +}; + +exports.sep = '/'; +exports.delimiter = ':'; + +exports.dirname = function(path) { + var result = splitPath(path), + root = result[0], + dir = result[1]; + + if (!root && !dir) { + // No dirname whatsoever + return '.'; + } + + if (dir) { + // It has a dirname, strip trailing slash + dir = dir.substr(0, dir.length - 1); + } + + return root + dir; +}; + + +exports.basename = function(path, ext) { + var f = splitPath(path)[2]; + // TODO: make this comparison case-insensitive on windows? + if (ext && f.substr(-1 * ext.length) === ext) { + f = f.substr(0, f.length - ext.length); + } + return f; +}; + + +exports.extname = function(path) { + return splitPath(path)[3]; +}; + +function filter (xs, f) { + if (xs.filter) return xs.filter(f); + var res = []; + for (var i = 0; i < xs.length; i++) { + if (f(xs[i], i, xs)) res.push(xs[i]); + } + return res; +} + +// String.prototype.substr - negative index don't work in IE8 +var substr = 'ab'.substr(-1) === 'b' + ? function (str, start, len) { return str.substr(start, len) } + : function (str, start, len) { + if (start < 0) start = str.length + start; + return str.substr(start, len); + } +; + +}).call(this,require('_process')) +},{"_process":24}],23:[function(require,module,exports){ +(function (process){ +'use strict'; + +function posix(path) { + return path.charAt(0) === '/'; +} + +function win32(path) { + // https://github.com/nodejs/node/blob/b3fcc245fb25539909ef1d5eaa01dbf92e168633/lib/path.js#L56 + var splitDeviceRe = /^([a-zA-Z]:|[\\\/]{2}[^\\\/]+[\\\/]+[^\\\/]+)?([\\\/])?([\s\S]*?)$/; + var result = splitDeviceRe.exec(path); + var device = result[1] || ''; + var isUnc = Boolean(device && device.charAt(1) !== ':'); + + // UNC paths are always absolute + return Boolean(result[2] || isUnc); +} + +module.exports = process.platform === 'win32' ? win32 : posix; +module.exports.posix = posix; +module.exports.win32 = win32; + +}).call(this,require('_process')) +},{"_process":24}],24:[function(require,module,exports){ +// shim for using process in browser +var process = module.exports = {}; + +// cached from whatever global is present so that test runners that stub it +// don't break things. But we need to wrap it in a try catch in case it is +// wrapped in strict mode code which doesn't define any globals. It's inside a +// function because try/catches deoptimize in certain engines. + +var cachedSetTimeout; +var cachedClearTimeout; + +function defaultSetTimout() { + throw new Error('setTimeout has not been defined'); +} +function defaultClearTimeout () { + throw new Error('clearTimeout has not been defined'); +} +(function () { + try { + if (typeof setTimeout === 'function') { + cachedSetTimeout = setTimeout; + } else { + cachedSetTimeout = defaultSetTimout; + } + } catch (e) { + cachedSetTimeout = defaultSetTimout; + } + try { + if (typeof clearTimeout === 'function') { + cachedClearTimeout = clearTimeout; + } else { + cachedClearTimeout = defaultClearTimeout; + } + } catch (e) { + cachedClearTimeout = defaultClearTimeout; + } +} ()) +function runTimeout(fun) { + if (cachedSetTimeout === setTimeout) { + //normal enviroments in sane situations + return setTimeout(fun, 0); + } + // if setTimeout wasn't available but was latter defined + if ((cachedSetTimeout === defaultSetTimout || !cachedSetTimeout) && setTimeout) { + cachedSetTimeout = setTimeout; + return setTimeout(fun, 0); + } + try { + // when when somebody has screwed with setTimeout but no I.E. maddness + return cachedSetTimeout(fun, 0); + } catch(e){ + try { + // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally + return cachedSetTimeout.call(null, fun, 0); + } catch(e){ + // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error + return cachedSetTimeout.call(this, fun, 0); + } + } + + +} +function runClearTimeout(marker) { + if (cachedClearTimeout === clearTimeout) { + //normal enviroments in sane situations + return clearTimeout(marker); + } + // if clearTimeout wasn't available but was latter defined + if ((cachedClearTimeout === defaultClearTimeout || !cachedClearTimeout) && clearTimeout) { + cachedClearTimeout = clearTimeout; + return clearTimeout(marker); + } + try { + // when when somebody has screwed with setTimeout but no I.E. maddness + return cachedClearTimeout(marker); + } catch (e){ + try { + // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally + return cachedClearTimeout.call(null, marker); + } catch (e){ + // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error. + // Some versions of I.E. have different rules for clearTimeout vs setTimeout + return cachedClearTimeout.call(this, marker); + } + } + + + +} +var queue = []; +var draining = false; +var currentQueue; +var queueIndex = -1; + +function cleanUpNextTick() { + if (!draining || !currentQueue) { + return; + } + draining = false; + if (currentQueue.length) { + queue = currentQueue.concat(queue); + } else { + queueIndex = -1; + } + if (queue.length) { + drainQueue(); + } +} + +function drainQueue() { + if (draining) { + return; + } + var timeout = runTimeout(cleanUpNextTick); + draining = true; + + var len = queue.length; + while(len) { + currentQueue = queue; + queue = []; + while (++queueIndex < len) { + if (currentQueue) { + currentQueue[queueIndex].run(); + } + } + queueIndex = -1; + len = queue.length; + } + currentQueue = null; + draining = false; + runClearTimeout(timeout); +} + +process.nextTick = function (fun) { + var args = new Array(arguments.length - 1); + if (arguments.length > 1) { + for (var i = 1; i < arguments.length; i++) { + args[i - 1] = arguments[i]; + } + } + queue.push(new Item(fun, args)); + if (queue.length === 1 && !draining) { + runTimeout(drainQueue); + } +}; + +// v8 likes predictible objects +function Item(fun, array) { + this.fun = fun; + this.array = array; +} +Item.prototype.run = function () { + this.fun.apply(null, this.array); +}; +process.title = 'browser'; +process.browser = true; +process.env = {}; +process.argv = []; +process.version = ''; // empty string to avoid regexp issues +process.versions = {}; + +function noop() {} + +process.on = noop; +process.addListener = noop; +process.once = noop; +process.off = noop; +process.removeListener = noop; +process.removeAllListeners = noop; +process.emit = noop; +process.prependListener = noop; +process.prependOnceListener = noop; + +process.listeners = function (name) { return [] } + +process.binding = function (name) { + throw new Error('process.binding is not supported'); +}; + +process.cwd = function () { return '/' }; +process.chdir = function (dir) { + throw new Error('process.chdir is not supported'); +}; +process.umask = function() { return 0; }; + +},{}],25:[function(require,module,exports){ +// Underscore.js 1.8.3 +// http://underscorejs.org +// (c) 2009-2015 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors +// Underscore may be freely distributed under the MIT license. + +(function() { + + // Baseline setup + // -------------- + + // Establish the root object, `window` in the browser, or `exports` on the server. + var root = this; + + // Save the previous value of the `_` variable. + var previousUnderscore = root._; + + // Save bytes in the minified (but not gzipped) version: + var ArrayProto = Array.prototype, ObjProto = Object.prototype, FuncProto = Function.prototype; + + // Create quick reference variables for speed access to core prototypes. + var + push = ArrayProto.push, + slice = ArrayProto.slice, + toString = ObjProto.toString, + hasOwnProperty = ObjProto.hasOwnProperty; + + // All **ECMAScript 5** native function implementations that we hope to use + // are declared here. + var + nativeIsArray = Array.isArray, + nativeKeys = Object.keys, + nativeBind = FuncProto.bind, + nativeCreate = Object.create; + + // Naked function reference for surrogate-prototype-swapping. + var Ctor = function(){}; + + // Create a safe reference to the Underscore object for use below. + var _ = function(obj) { + if (obj instanceof _) return obj; + if (!(this instanceof _)) return new _(obj); + this._wrapped = obj; + }; + + // Export the Underscore object for **Node.js**, with + // backwards-compatibility for the old `require()` API. If we're in + // the browser, add `_` as a global object. + if (typeof exports !== 'undefined') { + if (typeof module !== 'undefined' && module.exports) { + exports = module.exports = _; + } + exports._ = _; + } else { + root._ = _; + } + + // Current version. + _.VERSION = '1.8.3'; + + // Internal function that returns an efficient (for current engines) version + // of the passed-in callback, to be repeatedly applied in other Underscore + // functions. + var optimizeCb = function(func, context, argCount) { + if (context === void 0) return func; + switch (argCount == null ? 3 : argCount) { + case 1: return function(value) { + return func.call(context, value); + }; + case 2: return function(value, other) { + return func.call(context, value, other); + }; + case 3: return function(value, index, collection) { + return func.call(context, value, index, collection); + }; + case 4: return function(accumulator, value, index, collection) { + return func.call(context, accumulator, value, index, collection); + }; + } + return function() { + return func.apply(context, arguments); + }; + }; + + // A mostly-internal function to generate callbacks that can be applied + // to each element in a collection, returning the desired result — either + // identity, an arbitrary callback, a property matcher, or a property accessor. + var cb = function(value, context, argCount) { + if (value == null) return _.identity; + if (_.isFunction(value)) return optimizeCb(value, context, argCount); + if (_.isObject(value)) return _.matcher(value); + return _.property(value); + }; + _.iteratee = function(value, context) { + return cb(value, context, Infinity); + }; + + // An internal function for creating assigner functions. + var createAssigner = function(keysFunc, undefinedOnly) { + return function(obj) { + var length = arguments.length; + if (length < 2 || obj == null) return obj; + for (var index = 1; index < length; index++) { + var source = arguments[index], + keys = keysFunc(source), + l = keys.length; + for (var i = 0; i < l; i++) { + var key = keys[i]; + if (!undefinedOnly || obj[key] === void 0) obj[key] = source[key]; + } + } + return obj; + }; + }; + + // An internal function for creating a new object that inherits from another. + var baseCreate = function(prototype) { + if (!_.isObject(prototype)) return {}; + if (nativeCreate) return nativeCreate(prototype); + Ctor.prototype = prototype; + var result = new Ctor; + Ctor.prototype = null; + return result; + }; + + var property = function(key) { + return function(obj) { + return obj == null ? void 0 : obj[key]; + }; + }; + + // Helper for collection methods to determine whether a collection + // should be iterated as an array or as an object + // Related: http://people.mozilla.org/~jorendorff/es6-draft.html#sec-tolength + // Avoids a very nasty iOS 8 JIT bug on ARM-64. #2094 + var MAX_ARRAY_INDEX = Math.pow(2, 53) - 1; + var getLength = property('length'); + var isArrayLike = function(collection) { + var length = getLength(collection); + return typeof length == 'number' && length >= 0 && length <= MAX_ARRAY_INDEX; + }; + + // Collection Functions + // -------------------- + + // The cornerstone, an `each` implementation, aka `forEach`. + // Handles raw objects in addition to array-likes. Treats all + // sparse array-likes as if they were dense. + _.each = _.forEach = function(obj, iteratee, context) { + iteratee = optimizeCb(iteratee, context); + var i, length; + if (isArrayLike(obj)) { + for (i = 0, length = obj.length; i < length; i++) { + iteratee(obj[i], i, obj); + } + } else { + var keys = _.keys(obj); + for (i = 0, length = keys.length; i < length; i++) { + iteratee(obj[keys[i]], keys[i], obj); + } + } + return obj; + }; + + // Return the results of applying the iteratee to each element. + _.map = _.collect = function(obj, iteratee, context) { + iteratee = cb(iteratee, context); + var keys = !isArrayLike(obj) && _.keys(obj), + length = (keys || obj).length, + results = Array(length); + for (var index = 0; index < length; index++) { + var currentKey = keys ? keys[index] : index; + results[index] = iteratee(obj[currentKey], currentKey, obj); + } + return results; + }; + + // Create a reducing function iterating left or right. + function createReduce(dir) { + // Optimized iterator function as using arguments.length + // in the main function will deoptimize the, see #1991. + function iterator(obj, iteratee, memo, keys, index, length) { + for (; index >= 0 && index < length; index += dir) { + var currentKey = keys ? keys[index] : index; + memo = iteratee(memo, obj[currentKey], currentKey, obj); + } + return memo; + } + + return function(obj, iteratee, memo, context) { + iteratee = optimizeCb(iteratee, context, 4); + var keys = !isArrayLike(obj) && _.keys(obj), + length = (keys || obj).length, + index = dir > 0 ? 0 : length - 1; + // Determine the initial value if none is provided. + if (arguments.length < 3) { + memo = obj[keys ? keys[index] : index]; + index += dir; + } + return iterator(obj, iteratee, memo, keys, index, length); + }; + } + + // **Reduce** builds up a single result from a list of values, aka `inject`, + // or `foldl`. + _.reduce = _.foldl = _.inject = createReduce(1); + + // The right-associative version of reduce, also known as `foldr`. + _.reduceRight = _.foldr = createReduce(-1); + + // Return the first value which passes a truth test. Aliased as `detect`. + _.find = _.detect = function(obj, predicate, context) { + var key; + if (isArrayLike(obj)) { + key = _.findIndex(obj, predicate, context); + } else { + key = _.findKey(obj, predicate, context); + } + if (key !== void 0 && key !== -1) return obj[key]; + }; + + // Return all the elements that pass a truth test. + // Aliased as `select`. + _.filter = _.select = function(obj, predicate, context) { + var results = []; + predicate = cb(predicate, context); + _.each(obj, function(value, index, list) { + if (predicate(value, index, list)) results.push(value); + }); + return results; + }; + + // Return all the elements for which a truth test fails. + _.reject = function(obj, predicate, context) { + return _.filter(obj, _.negate(cb(predicate)), context); + }; + + // Determine whether all of the elements match a truth test. + // Aliased as `all`. + _.every = _.all = function(obj, predicate, context) { + predicate = cb(predicate, context); + var keys = !isArrayLike(obj) && _.keys(obj), + length = (keys || obj).length; + for (var index = 0; index < length; index++) { + var currentKey = keys ? keys[index] : index; + if (!predicate(obj[currentKey], currentKey, obj)) return false; + } + return true; + }; + + // Determine if at least one element in the object matches a truth test. + // Aliased as `any`. + _.some = _.any = function(obj, predicate, context) { + predicate = cb(predicate, context); + var keys = !isArrayLike(obj) && _.keys(obj), + length = (keys || obj).length; + for (var index = 0; index < length; index++) { + var currentKey = keys ? keys[index] : index; + if (predicate(obj[currentKey], currentKey, obj)) return true; + } + return false; + }; + + // Determine if the array or object contains a given item (using `===`). + // Aliased as `includes` and `include`. + _.contains = _.includes = _.include = function(obj, item, fromIndex, guard) { + if (!isArrayLike(obj)) obj = _.values(obj); + if (typeof fromIndex != 'number' || guard) fromIndex = 0; + return _.indexOf(obj, item, fromIndex) >= 0; + }; + + // Invoke a method (with arguments) on every item in a collection. + _.invoke = function(obj, method) { + var args = slice.call(arguments, 2); + var isFunc = _.isFunction(method); + return _.map(obj, function(value) { + var func = isFunc ? method : value[method]; + return func == null ? func : func.apply(value, args); + }); + }; + + // Convenience version of a common use case of `map`: fetching a property. + _.pluck = function(obj, key) { + return _.map(obj, _.property(key)); + }; + + // Convenience version of a common use case of `filter`: selecting only objects + // containing specific `key:value` pairs. + _.where = function(obj, attrs) { + return _.filter(obj, _.matcher(attrs)); + }; + + // Convenience version of a common use case of `find`: getting the first object + // containing specific `key:value` pairs. + _.findWhere = function(obj, attrs) { + return _.find(obj, _.matcher(attrs)); + }; + + // Return the maximum element (or element-based computation). + _.max = function(obj, iteratee, context) { + var result = -Infinity, lastComputed = -Infinity, + value, computed; + if (iteratee == null && obj != null) { + obj = isArrayLike(obj) ? obj : _.values(obj); + for (var i = 0, length = obj.length; i < length; i++) { + value = obj[i]; + if (value > result) { + result = value; + } + } + } else { + iteratee = cb(iteratee, context); + _.each(obj, function(value, index, list) { + computed = iteratee(value, index, list); + if (computed > lastComputed || computed === -Infinity && result === -Infinity) { + result = value; + lastComputed = computed; + } + }); + } + return result; + }; + + // Return the minimum element (or element-based computation). + _.min = function(obj, iteratee, context) { + var result = Infinity, lastComputed = Infinity, + value, computed; + if (iteratee == null && obj != null) { + obj = isArrayLike(obj) ? obj : _.values(obj); + for (var i = 0, length = obj.length; i < length; i++) { + value = obj[i]; + if (value < result) { + result = value; + } + } + } else { + iteratee = cb(iteratee, context); + _.each(obj, function(value, index, list) { + computed = iteratee(value, index, list); + if (computed < lastComputed || computed === Infinity && result === Infinity) { + result = value; + lastComputed = computed; + } + }); + } + return result; + }; + + // Shuffle a collection, using the modern version of the + // [Fisher-Yates shuffle](http://en.wikipedia.org/wiki/Fisher–Yates_shuffle). + _.shuffle = function(obj) { + var set = isArrayLike(obj) ? obj : _.values(obj); + var length = set.length; + var shuffled = Array(length); + for (var index = 0, rand; index < length; index++) { + rand = _.random(0, index); + if (rand !== index) shuffled[index] = shuffled[rand]; + shuffled[rand] = set[index]; + } + return shuffled; + }; + + // Sample **n** random values from a collection. + // If **n** is not specified, returns a single random element. + // The internal `guard` argument allows it to work with `map`. + _.sample = function(obj, n, guard) { + if (n == null || guard) { + if (!isArrayLike(obj)) obj = _.values(obj); + return obj[_.random(obj.length - 1)]; + } + return _.shuffle(obj).slice(0, Math.max(0, n)); + }; + + // Sort the object's values by a criterion produced by an iteratee. + _.sortBy = function(obj, iteratee, context) { + iteratee = cb(iteratee, context); + return _.pluck(_.map(obj, function(value, index, list) { + return { + value: value, + index: index, + criteria: iteratee(value, index, list) + }; + }).sort(function(left, right) { + var a = left.criteria; + var b = right.criteria; + if (a !== b) { + if (a > b || a === void 0) return 1; + if (a < b || b === void 0) return -1; + } + return left.index - right.index; + }), 'value'); + }; + + // An internal function used for aggregate "group by" operations. + var group = function(behavior) { + return function(obj, iteratee, context) { + var result = {}; + iteratee = cb(iteratee, context); + _.each(obj, function(value, index) { + var key = iteratee(value, index, obj); + behavior(result, value, key); + }); + return result; + }; + }; + + // Groups the object's values by a criterion. Pass either a string attribute + // to group by, or a function that returns the criterion. + _.groupBy = group(function(result, value, key) { + if (_.has(result, key)) result[key].push(value); else result[key] = [value]; + }); + + // Indexes the object's values by a criterion, similar to `groupBy`, but for + // when you know that your index values will be unique. + _.indexBy = group(function(result, value, key) { + result[key] = value; + }); + + // Counts instances of an object that group by a certain criterion. Pass + // either a string attribute to count by, or a function that returns the + // criterion. + _.countBy = group(function(result, value, key) { + if (_.has(result, key)) result[key]++; else result[key] = 1; + }); + + // Safely create a real, live array from anything iterable. + _.toArray = function(obj) { + if (!obj) return []; + if (_.isArray(obj)) return slice.call(obj); + if (isArrayLike(obj)) return _.map(obj, _.identity); + return _.values(obj); + }; + + // Return the number of elements in an object. + _.size = function(obj) { + if (obj == null) return 0; + return isArrayLike(obj) ? obj.length : _.keys(obj).length; + }; + + // Split a collection into two arrays: one whose elements all satisfy the given + // predicate, and one whose elements all do not satisfy the predicate. + _.partition = function(obj, predicate, context) { + predicate = cb(predicate, context); + var pass = [], fail = []; + _.each(obj, function(value, key, obj) { + (predicate(value, key, obj) ? pass : fail).push(value); + }); + return [pass, fail]; + }; + + // Array Functions + // --------------- + + // Get the first element of an array. Passing **n** will return the first N + // values in the array. Aliased as `head` and `take`. The **guard** check + // allows it to work with `_.map`. + _.first = _.head = _.take = function(array, n, guard) { + if (array == null) return void 0; + if (n == null || guard) return array[0]; + return _.initial(array, array.length - n); + }; + + // Returns everything but the last entry of the array. Especially useful on + // the arguments object. Passing **n** will return all the values in + // the array, excluding the last N. + _.initial = function(array, n, guard) { + return slice.call(array, 0, Math.max(0, array.length - (n == null || guard ? 1 : n))); + }; + + // Get the last element of an array. Passing **n** will return the last N + // values in the array. + _.last = function(array, n, guard) { + if (array == null) return void 0; + if (n == null || guard) return array[array.length - 1]; + return _.rest(array, Math.max(0, array.length - n)); + }; + + // Returns everything but the first entry of the array. Aliased as `tail` and `drop`. + // Especially useful on the arguments object. Passing an **n** will return + // the rest N values in the array. + _.rest = _.tail = _.drop = function(array, n, guard) { + return slice.call(array, n == null || guard ? 1 : n); + }; + + // Trim out all falsy values from an array. + _.compact = function(array) { + return _.filter(array, _.identity); + }; + + // Internal implementation of a recursive `flatten` function. + var flatten = function(input, shallow, strict, startIndex) { + var output = [], idx = 0; + for (var i = startIndex || 0, length = getLength(input); i < length; i++) { + var value = input[i]; + if (isArrayLike(value) && (_.isArray(value) || _.isArguments(value))) { + //flatten current level of array or arguments object + if (!shallow) value = flatten(value, shallow, strict); + var j = 0, len = value.length; + output.length += len; + while (j < len) { + output[idx++] = value[j++]; + } + } else if (!strict) { + output[idx++] = value; + } + } + return output; + }; + + // Flatten out an array, either recursively (by default), or just one level. + _.flatten = function(array, shallow) { + return flatten(array, shallow, false); + }; + + // Return a version of the array that does not contain the specified value(s). + _.without = function(array) { + return _.difference(array, slice.call(arguments, 1)); + }; + + // Produce a duplicate-free version of the array. If the array has already + // been sorted, you have the option of using a faster algorithm. + // Aliased as `unique`. + _.uniq = _.unique = function(array, isSorted, iteratee, context) { + if (!_.isBoolean(isSorted)) { + context = iteratee; + iteratee = isSorted; + isSorted = false; + } + if (iteratee != null) iteratee = cb(iteratee, context); + var result = []; + var seen = []; + for (var i = 0, length = getLength(array); i < length; i++) { + var value = array[i], + computed = iteratee ? iteratee(value, i, array) : value; + if (isSorted) { + if (!i || seen !== computed) result.push(value); + seen = computed; + } else if (iteratee) { + if (!_.contains(seen, computed)) { + seen.push(computed); + result.push(value); + } + } else if (!_.contains(result, value)) { + result.push(value); + } + } + return result; + }; + + // Produce an array that contains the union: each distinct element from all of + // the passed-in arrays. + _.union = function() { + return _.uniq(flatten(arguments, true, true)); + }; + + // Produce an array that contains every item shared between all the + // passed-in arrays. + _.intersection = function(array) { + var result = []; + var argsLength = arguments.length; + for (var i = 0, length = getLength(array); i < length; i++) { + var item = array[i]; + if (_.contains(result, item)) continue; + for (var j = 1; j < argsLength; j++) { + if (!_.contains(arguments[j], item)) break; + } + if (j === argsLength) result.push(item); + } + return result; + }; + + // Take the difference between one array and a number of other arrays. + // Only the elements present in just the first array will remain. + _.difference = function(array) { + var rest = flatten(arguments, true, true, 1); + return _.filter(array, function(value){ + return !_.contains(rest, value); + }); + }; + + // Zip together multiple lists into a single array -- elements that share + // an index go together. + _.zip = function() { + return _.unzip(arguments); + }; + + // Complement of _.zip. Unzip accepts an array of arrays and groups + // each array's elements on shared indices + _.unzip = function(array) { + var length = array && _.max(array, getLength).length || 0; + var result = Array(length); + + for (var index = 0; index < length; index++) { + result[index] = _.pluck(array, index); + } + return result; + }; + + // Converts lists into objects. Pass either a single array of `[key, value]` + // pairs, or two parallel arrays of the same length -- one of keys, and one of + // the corresponding values. + _.object = function(list, values) { + var result = {}; + for (var i = 0, length = getLength(list); i < length; i++) { + if (values) { + result[list[i]] = values[i]; + } else { + result[list[i][0]] = list[i][1]; + } + } + return result; + }; + + // Generator function to create the findIndex and findLastIndex functions + function createPredicateIndexFinder(dir) { + return function(array, predicate, context) { + predicate = cb(predicate, context); + var length = getLength(array); + var index = dir > 0 ? 0 : length - 1; + for (; index >= 0 && index < length; index += dir) { + if (predicate(array[index], index, array)) return index; + } + return -1; + }; + } + + // Returns the first index on an array-like that passes a predicate test + _.findIndex = createPredicateIndexFinder(1); + _.findLastIndex = createPredicateIndexFinder(-1); + + // Use a comparator function to figure out the smallest index at which + // an object should be inserted so as to maintain order. Uses binary search. + _.sortedIndex = function(array, obj, iteratee, context) { + iteratee = cb(iteratee, context, 1); + var value = iteratee(obj); + var low = 0, high = getLength(array); + while (low < high) { + var mid = Math.floor((low + high) / 2); + if (iteratee(array[mid]) < value) low = mid + 1; else high = mid; + } + return low; + }; + + // Generator function to create the indexOf and lastIndexOf functions + function createIndexFinder(dir, predicateFind, sortedIndex) { + return function(array, item, idx) { + var i = 0, length = getLength(array); + if (typeof idx == 'number') { + if (dir > 0) { + i = idx >= 0 ? idx : Math.max(idx + length, i); + } else { + length = idx >= 0 ? Math.min(idx + 1, length) : idx + length + 1; + } + } else if (sortedIndex && idx && length) { + idx = sortedIndex(array, item); + return array[idx] === item ? idx : -1; + } + if (item !== item) { + idx = predicateFind(slice.call(array, i, length), _.isNaN); + return idx >= 0 ? idx + i : -1; + } + for (idx = dir > 0 ? i : length - 1; idx >= 0 && idx < length; idx += dir) { + if (array[idx] === item) return idx; + } + return -1; + }; + } + + // Return the position of the first occurrence of an item in an array, + // or -1 if the item is not included in the array. + // If the array is large and already in sort order, pass `true` + // for **isSorted** to use binary search. + _.indexOf = createIndexFinder(1, _.findIndex, _.sortedIndex); + _.lastIndexOf = createIndexFinder(-1, _.findLastIndex); + + // Generate an integer Array containing an arithmetic progression. A port of + // the native Python `range()` function. See + // [the Python documentation](http://docs.python.org/library/functions.html#range). + _.range = function(start, stop, step) { + if (stop == null) { + stop = start || 0; + start = 0; + } + step = step || 1; + + var length = Math.max(Math.ceil((stop - start) / step), 0); + var range = Array(length); + + for (var idx = 0; idx < length; idx++, start += step) { + range[idx] = start; + } + + return range; + }; + + // Function (ahem) Functions + // ------------------ + + // Determines whether to execute a function as a constructor + // or a normal function with the provided arguments + var executeBound = function(sourceFunc, boundFunc, context, callingContext, args) { + if (!(callingContext instanceof boundFunc)) return sourceFunc.apply(context, args); + var self = baseCreate(sourceFunc.prototype); + var result = sourceFunc.apply(self, args); + if (_.isObject(result)) return result; + return self; + }; + + // Create a function bound to a given object (assigning `this`, and arguments, + // optionally). Delegates to **ECMAScript 5**'s native `Function.bind` if + // available. + _.bind = function(func, context) { + if (nativeBind && func.bind === nativeBind) return nativeBind.apply(func, slice.call(arguments, 1)); + if (!_.isFunction(func)) throw new TypeError('Bind must be called on a function'); + var args = slice.call(arguments, 2); + var bound = function() { + return executeBound(func, bound, context, this, args.concat(slice.call(arguments))); + }; + return bound; + }; + + // Partially apply a function by creating a version that has had some of its + // arguments pre-filled, without changing its dynamic `this` context. _ acts + // as a placeholder, allowing any combination of arguments to be pre-filled. + _.partial = function(func) { + var boundArgs = slice.call(arguments, 1); + var bound = function() { + var position = 0, length = boundArgs.length; + var args = Array(length); + for (var i = 0; i < length; i++) { + args[i] = boundArgs[i] === _ ? arguments[position++] : boundArgs[i]; + } + while (position < arguments.length) args.push(arguments[position++]); + return executeBound(func, bound, this, this, args); + }; + return bound; + }; + + // Bind a number of an object's methods to that object. Remaining arguments + // are the method names to be bound. Useful for ensuring that all callbacks + // defined on an object belong to it. + _.bindAll = function(obj) { + var i, length = arguments.length, key; + if (length <= 1) throw new Error('bindAll must be passed function names'); + for (i = 1; i < length; i++) { + key = arguments[i]; + obj[key] = _.bind(obj[key], obj); + } + return obj; + }; + + // Memoize an expensive function by storing its results. + _.memoize = function(func, hasher) { + var memoize = function(key) { + var cache = memoize.cache; + var address = '' + (hasher ? hasher.apply(this, arguments) : key); + if (!_.has(cache, address)) cache[address] = func.apply(this, arguments); + return cache[address]; + }; + memoize.cache = {}; + return memoize; + }; + + // Delays a function for the given number of milliseconds, and then calls + // it with the arguments supplied. + _.delay = function(func, wait) { + var args = slice.call(arguments, 2); + return setTimeout(function(){ + return func.apply(null, args); + }, wait); + }; + + // Defers a function, scheduling it to run after the current call stack has + // cleared. + _.defer = _.partial(_.delay, _, 1); + + // Returns a function, that, when invoked, will only be triggered at most once + // during a given window of time. Normally, the throttled function will run + // as much as it can, without ever going more than once per `wait` duration; + // but if you'd like to disable the execution on the leading edge, pass + // `{leading: false}`. To disable execution on the trailing edge, ditto. + _.throttle = function(func, wait, options) { + var context, args, result; + var timeout = null; + var previous = 0; + if (!options) options = {}; + var later = function() { + previous = options.leading === false ? 0 : _.now(); + timeout = null; + result = func.apply(context, args); + if (!timeout) context = args = null; + }; + return function() { + var now = _.now(); + if (!previous && options.leading === false) previous = now; + var remaining = wait - (now - previous); + context = this; + args = arguments; + if (remaining <= 0 || remaining > wait) { + if (timeout) { + clearTimeout(timeout); + timeout = null; + } + previous = now; + result = func.apply(context, args); + if (!timeout) context = args = null; + } else if (!timeout && options.trailing !== false) { + timeout = setTimeout(later, remaining); + } + return result; + }; + }; + + // Returns a function, that, as long as it continues to be invoked, will not + // be triggered. The function will be called after it stops being called for + // N milliseconds. If `immediate` is passed, trigger the function on the + // leading edge, instead of the trailing. + _.debounce = function(func, wait, immediate) { + var timeout, args, context, timestamp, result; + + var later = function() { + var last = _.now() - timestamp; + + if (last < wait && last >= 0) { + timeout = setTimeout(later, wait - last); + } else { + timeout = null; + if (!immediate) { + result = func.apply(context, args); + if (!timeout) context = args = null; + } + } + }; + + return function() { + context = this; + args = arguments; + timestamp = _.now(); + var callNow = immediate && !timeout; + if (!timeout) timeout = setTimeout(later, wait); + if (callNow) { + result = func.apply(context, args); + context = args = null; + } + + return result; + }; + }; + + // Returns the first function passed as an argument to the second, + // allowing you to adjust arguments, run code before and after, and + // conditionally execute the original function. + _.wrap = function(func, wrapper) { + return _.partial(wrapper, func); + }; + + // Returns a negated version of the passed-in predicate. + _.negate = function(predicate) { + return function() { + return !predicate.apply(this, arguments); + }; + }; + + // Returns a function that is the composition of a list of functions, each + // consuming the return value of the function that follows. + _.compose = function() { + var args = arguments; + var start = args.length - 1; + return function() { + var i = start; + var result = args[start].apply(this, arguments); + while (i--) result = args[i].call(this, result); + return result; + }; + }; + + // Returns a function that will only be executed on and after the Nth call. + _.after = function(times, func) { + return function() { + if (--times < 1) { + return func.apply(this, arguments); + } + }; + }; + + // Returns a function that will only be executed up to (but not including) the Nth call. + _.before = function(times, func) { + var memo; + return function() { + if (--times > 0) { + memo = func.apply(this, arguments); + } + if (times <= 1) func = null; + return memo; + }; + }; + + // Returns a function that will be executed at most one time, no matter how + // often you call it. Useful for lazy initialization. + _.once = _.partial(_.before, 2); + + // Object Functions + // ---------------- + + // Keys in IE < 9 that won't be iterated by `for key in ...` and thus missed. + var hasEnumBug = !{toString: null}.propertyIsEnumerable('toString'); + var nonEnumerableProps = ['valueOf', 'isPrototypeOf', 'toString', + 'propertyIsEnumerable', 'hasOwnProperty', 'toLocaleString']; + + function collectNonEnumProps(obj, keys) { + var nonEnumIdx = nonEnumerableProps.length; + var constructor = obj.constructor; + var proto = (_.isFunction(constructor) && constructor.prototype) || ObjProto; + + // Constructor is a special case. + var prop = 'constructor'; + if (_.has(obj, prop) && !_.contains(keys, prop)) keys.push(prop); + + while (nonEnumIdx--) { + prop = nonEnumerableProps[nonEnumIdx]; + if (prop in obj && obj[prop] !== proto[prop] && !_.contains(keys, prop)) { + keys.push(prop); + } + } + } + + // Retrieve the names of an object's own properties. + // Delegates to **ECMAScript 5**'s native `Object.keys` + _.keys = function(obj) { + if (!_.isObject(obj)) return []; + if (nativeKeys) return nativeKeys(obj); + var keys = []; + for (var key in obj) if (_.has(obj, key)) keys.push(key); + // Ahem, IE < 9. + if (hasEnumBug) collectNonEnumProps(obj, keys); + return keys; + }; + + // Retrieve all the property names of an object. + _.allKeys = function(obj) { + if (!_.isObject(obj)) return []; + var keys = []; + for (var key in obj) keys.push(key); + // Ahem, IE < 9. + if (hasEnumBug) collectNonEnumProps(obj, keys); + return keys; + }; + + // Retrieve the values of an object's properties. + _.values = function(obj) { + var keys = _.keys(obj); + var length = keys.length; + var values = Array(length); + for (var i = 0; i < length; i++) { + values[i] = obj[keys[i]]; + } + return values; + }; + + // Returns the results of applying the iteratee to each element of the object + // In contrast to _.map it returns an object + _.mapObject = function(obj, iteratee, context) { + iteratee = cb(iteratee, context); + var keys = _.keys(obj), + length = keys.length, + results = {}, + currentKey; + for (var index = 0; index < length; index++) { + currentKey = keys[index]; + results[currentKey] = iteratee(obj[currentKey], currentKey, obj); + } + return results; + }; + + // Convert an object into a list of `[key, value]` pairs. + _.pairs = function(obj) { + var keys = _.keys(obj); + var length = keys.length; + var pairs = Array(length); + for (var i = 0; i < length; i++) { + pairs[i] = [keys[i], obj[keys[i]]]; + } + return pairs; + }; + + // Invert the keys and values of an object. The values must be serializable. + _.invert = function(obj) { + var result = {}; + var keys = _.keys(obj); + for (var i = 0, length = keys.length; i < length; i++) { + result[obj[keys[i]]] = keys[i]; + } + return result; + }; + + // Return a sorted list of the function names available on the object. + // Aliased as `methods` + _.functions = _.methods = function(obj) { + var names = []; + for (var key in obj) { + if (_.isFunction(obj[key])) names.push(key); + } + return names.sort(); + }; + + // Extend a given object with all the properties in passed-in object(s). + _.extend = createAssigner(_.allKeys); + + // Assigns a given object with all the own properties in the passed-in object(s) + // (https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/assign) + _.extendOwn = _.assign = createAssigner(_.keys); + + // Returns the first key on an object that passes a predicate test + _.findKey = function(obj, predicate, context) { + predicate = cb(predicate, context); + var keys = _.keys(obj), key; + for (var i = 0, length = keys.length; i < length; i++) { + key = keys[i]; + if (predicate(obj[key], key, obj)) return key; + } + }; + + // Return a copy of the object only containing the whitelisted properties. + _.pick = function(object, oiteratee, context) { + var result = {}, obj = object, iteratee, keys; + if (obj == null) return result; + if (_.isFunction(oiteratee)) { + keys = _.allKeys(obj); + iteratee = optimizeCb(oiteratee, context); + } else { + keys = flatten(arguments, false, false, 1); + iteratee = function(value, key, obj) { return key in obj; }; + obj = Object(obj); + } + for (var i = 0, length = keys.length; i < length; i++) { + var key = keys[i]; + var value = obj[key]; + if (iteratee(value, key, obj)) result[key] = value; + } + return result; + }; + + // Return a copy of the object without the blacklisted properties. + _.omit = function(obj, iteratee, context) { + if (_.isFunction(iteratee)) { + iteratee = _.negate(iteratee); + } else { + var keys = _.map(flatten(arguments, false, false, 1), String); + iteratee = function(value, key) { + return !_.contains(keys, key); + }; + } + return _.pick(obj, iteratee, context); + }; + + // Fill in a given object with default properties. + _.defaults = createAssigner(_.allKeys, true); + + // Creates an object that inherits from the given prototype object. + // If additional properties are provided then they will be added to the + // created object. + _.create = function(prototype, props) { + var result = baseCreate(prototype); + if (props) _.extendOwn(result, props); + return result; + }; + + // Create a (shallow-cloned) duplicate of an object. + _.clone = function(obj) { + if (!_.isObject(obj)) return obj; + return _.isArray(obj) ? obj.slice() : _.extend({}, obj); + }; + + // Invokes interceptor with the obj, and then returns obj. + // The primary purpose of this method is to "tap into" a method chain, in + // order to perform operations on intermediate results within the chain. + _.tap = function(obj, interceptor) { + interceptor(obj); + return obj; + }; + + // Returns whether an object has a given set of `key:value` pairs. + _.isMatch = function(object, attrs) { + var keys = _.keys(attrs), length = keys.length; + if (object == null) return !length; + var obj = Object(object); + for (var i = 0; i < length; i++) { + var key = keys[i]; + if (attrs[key] !== obj[key] || !(key in obj)) return false; + } + return true; + }; + + + // Internal recursive comparison function for `isEqual`. + var eq = function(a, b, aStack, bStack) { + // Identical objects are equal. `0 === -0`, but they aren't identical. + // See the [Harmony `egal` proposal](http://wiki.ecmascript.org/doku.php?id=harmony:egal). + if (a === b) return a !== 0 || 1 / a === 1 / b; + // A strict comparison is necessary because `null == undefined`. + if (a == null || b == null) return a === b; + // Unwrap any wrapped objects. + if (a instanceof _) a = a._wrapped; + if (b instanceof _) b = b._wrapped; + // Compare `[[Class]]` names. + var className = toString.call(a); + if (className !== toString.call(b)) return false; + switch (className) { + // Strings, numbers, regular expressions, dates, and booleans are compared by value. + case '[object RegExp]': + // RegExps are coerced to strings for comparison (Note: '' + /a/i === '/a/i') + case '[object String]': + // Primitives and their corresponding object wrappers are equivalent; thus, `"5"` is + // equivalent to `new String("5")`. + return '' + a === '' + b; + case '[object Number]': + // `NaN`s are equivalent, but non-reflexive. + // Object(NaN) is equivalent to NaN + if (+a !== +a) return +b !== +b; + // An `egal` comparison is performed for other numeric values. + return +a === 0 ? 1 / +a === 1 / b : +a === +b; + case '[object Date]': + case '[object Boolean]': + // Coerce dates and booleans to numeric primitive values. Dates are compared by their + // millisecond representations. Note that invalid dates with millisecond representations + // of `NaN` are not equivalent. + return +a === +b; + } + + var areArrays = className === '[object Array]'; + if (!areArrays) { + if (typeof a != 'object' || typeof b != 'object') return false; + + // Objects with different constructors are not equivalent, but `Object`s or `Array`s + // from different frames are. + var aCtor = a.constructor, bCtor = b.constructor; + if (aCtor !== bCtor && !(_.isFunction(aCtor) && aCtor instanceof aCtor && + _.isFunction(bCtor) && bCtor instanceof bCtor) + && ('constructor' in a && 'constructor' in b)) { + return false; + } + } + // Assume equality for cyclic structures. The algorithm for detecting cyclic + // structures is adapted from ES 5.1 section 15.12.3, abstract operation `JO`. + + // Initializing stack of traversed objects. + // It's done here since we only need them for objects and arrays comparison. + aStack = aStack || []; + bStack = bStack || []; + var length = aStack.length; + while (length--) { + // Linear search. Performance is inversely proportional to the number of + // unique nested structures. + if (aStack[length] === a) return bStack[length] === b; + } + + // Add the first object to the stack of traversed objects. + aStack.push(a); + bStack.push(b); + + // Recursively compare objects and arrays. + if (areArrays) { + // Compare array lengths to determine if a deep comparison is necessary. + length = a.length; + if (length !== b.length) return false; + // Deep compare the contents, ignoring non-numeric properties. + while (length--) { + if (!eq(a[length], b[length], aStack, bStack)) return false; + } + } else { + // Deep compare objects. + var keys = _.keys(a), key; + length = keys.length; + // Ensure that both objects contain the same number of properties before comparing deep equality. + if (_.keys(b).length !== length) return false; + while (length--) { + // Deep compare each member + key = keys[length]; + if (!(_.has(b, key) && eq(a[key], b[key], aStack, bStack))) return false; + } + } + // Remove the first object from the stack of traversed objects. + aStack.pop(); + bStack.pop(); + return true; + }; + + // Perform a deep comparison to check if two objects are equal. + _.isEqual = function(a, b) { + return eq(a, b); + }; + + // Is a given array, string, or object empty? + // An "empty" object has no enumerable own-properties. + _.isEmpty = function(obj) { + if (obj == null) return true; + if (isArrayLike(obj) && (_.isArray(obj) || _.isString(obj) || _.isArguments(obj))) return obj.length === 0; + return _.keys(obj).length === 0; + }; + + // Is a given value a DOM element? + _.isElement = function(obj) { + return !!(obj && obj.nodeType === 1); + }; + + // Is a given value an array? + // Delegates to ECMA5's native Array.isArray + _.isArray = nativeIsArray || function(obj) { + return toString.call(obj) === '[object Array]'; + }; + + // Is a given variable an object? + _.isObject = function(obj) { + var type = typeof obj; + return type === 'function' || type === 'object' && !!obj; + }; + + // Add some isType methods: isArguments, isFunction, isString, isNumber, isDate, isRegExp, isError. + _.each(['Arguments', 'Function', 'String', 'Number', 'Date', 'RegExp', 'Error'], function(name) { + _['is' + name] = function(obj) { + return toString.call(obj) === '[object ' + name + ']'; + }; + }); + + // Define a fallback version of the method in browsers (ahem, IE < 9), where + // there isn't any inspectable "Arguments" type. + if (!_.isArguments(arguments)) { + _.isArguments = function(obj) { + return _.has(obj, 'callee'); + }; + } + + // Optimize `isFunction` if appropriate. Work around some typeof bugs in old v8, + // IE 11 (#1621), and in Safari 8 (#1929). + if (typeof /./ != 'function' && typeof Int8Array != 'object') { + _.isFunction = function(obj) { + return typeof obj == 'function' || false; + }; + } + + // Is a given object a finite number? + _.isFinite = function(obj) { + return isFinite(obj) && !isNaN(parseFloat(obj)); + }; + + // Is the given value `NaN`? (NaN is the only number which does not equal itself). + _.isNaN = function(obj) { + return _.isNumber(obj) && obj !== +obj; + }; + + // Is a given value a boolean? + _.isBoolean = function(obj) { + return obj === true || obj === false || toString.call(obj) === '[object Boolean]'; + }; + + // Is a given value equal to null? + _.isNull = function(obj) { + return obj === null; + }; + + // Is a given variable undefined? + _.isUndefined = function(obj) { + return obj === void 0; + }; + + // Shortcut function for checking if an object has a given property directly + // on itself (in other words, not on a prototype). + _.has = function(obj, key) { + return obj != null && hasOwnProperty.call(obj, key); + }; + + // Utility Functions + // ----------------- + + // Run Underscore.js in *noConflict* mode, returning the `_` variable to its + // previous owner. Returns a reference to the Underscore object. + _.noConflict = function() { + root._ = previousUnderscore; + return this; + }; + + // Keep the identity function around for default iteratees. + _.identity = function(value) { + return value; + }; + + // Predicate-generating functions. Often useful outside of Underscore. + _.constant = function(value) { + return function() { + return value; + }; + }; + + _.noop = function(){}; + + _.property = property; + + // Generates a function for a given object that returns a given property. + _.propertyOf = function(obj) { + return obj == null ? function(){} : function(key) { + return obj[key]; + }; + }; + + // Returns a predicate for checking whether an object has a given set of + // `key:value` pairs. + _.matcher = _.matches = function(attrs) { + attrs = _.extendOwn({}, attrs); + return function(obj) { + return _.isMatch(obj, attrs); + }; + }; + + // Run a function **n** times. + _.times = function(n, iteratee, context) { + var accum = Array(Math.max(0, n)); + iteratee = optimizeCb(iteratee, context, 1); + for (var i = 0; i < n; i++) accum[i] = iteratee(i); + return accum; + }; + + // Return a random integer between min and max (inclusive). + _.random = function(min, max) { + if (max == null) { + max = min; + min = 0; + } + return min + Math.floor(Math.random() * (max - min + 1)); + }; + + // A (possibly faster) way to get the current timestamp as an integer. + _.now = Date.now || function() { + return new Date().getTime(); + }; + + // List of HTML entities for escaping. + var escapeMap = { + '&': '&', + '<': '<', + '>': '>', + '"': '"', + "'": ''', + '`': '`' + }; + var unescapeMap = _.invert(escapeMap); + + // Functions for escaping and unescaping strings to/from HTML interpolation. + var createEscaper = function(map) { + var escaper = function(match) { + return map[match]; + }; + // Regexes for identifying a key that needs to be escaped + var source = '(?:' + _.keys(map).join('|') + ')'; + var testRegexp = RegExp(source); + var replaceRegexp = RegExp(source, 'g'); + return function(string) { + string = string == null ? '' : '' + string; + return testRegexp.test(string) ? string.replace(replaceRegexp, escaper) : string; + }; + }; + _.escape = createEscaper(escapeMap); + _.unescape = createEscaper(unescapeMap); + + // If the value of the named `property` is a function then invoke it with the + // `object` as context; otherwise, return it. + _.result = function(object, property, fallback) { + var value = object == null ? void 0 : object[property]; + if (value === void 0) { + value = fallback; + } + return _.isFunction(value) ? value.call(object) : value; + }; + + // Generate a unique integer id (unique within the entire client session). + // Useful for temporary DOM ids. + var idCounter = 0; + _.uniqueId = function(prefix) { + var id = ++idCounter + ''; + return prefix ? prefix + id : id; + }; + + // By default, Underscore uses ERB-style template delimiters, change the + // following template settings to use alternative delimiters. + _.templateSettings = { + evaluate : /<%([\s\S]+?)%>/g, + interpolate : /<%=([\s\S]+?)%>/g, + escape : /<%-([\s\S]+?)%>/g + }; + + // When customizing `templateSettings`, if you don't want to define an + // interpolation, evaluation or escaping regex, we need one that is + // guaranteed not to match. + var noMatch = /(.)^/; + + // Certain characters need to be escaped so that they can be put into a + // string literal. + var escapes = { + "'": "'", + '\\': '\\', + '\r': 'r', + '\n': 'n', + '\u2028': 'u2028', + '\u2029': 'u2029' + }; + + var escaper = /\\|'|\r|\n|\u2028|\u2029/g; + + var escapeChar = function(match) { + return '\\' + escapes[match]; + }; + + // JavaScript micro-templating, similar to John Resig's implementation. + // Underscore templating handles arbitrary delimiters, preserves whitespace, + // and correctly escapes quotes within interpolated code. + // NB: `oldSettings` only exists for backwards compatibility. + _.template = function(text, settings, oldSettings) { + if (!settings && oldSettings) settings = oldSettings; + settings = _.defaults({}, settings, _.templateSettings); + + // Combine delimiters into one regular expression via alternation. + var matcher = RegExp([ + (settings.escape || noMatch).source, + (settings.interpolate || noMatch).source, + (settings.evaluate || noMatch).source + ].join('|') + '|$', 'g'); + + // Compile the template source, escaping string literals appropriately. + var index = 0; + var source = "__p+='"; + text.replace(matcher, function(match, escape, interpolate, evaluate, offset) { + source += text.slice(index, offset).replace(escaper, escapeChar); + index = offset + match.length; + + if (escape) { + source += "'+\n((__t=(" + escape + "))==null?'':_.escape(__t))+\n'"; + } else if (interpolate) { + source += "'+\n((__t=(" + interpolate + "))==null?'':__t)+\n'"; + } else if (evaluate) { + source += "';\n" + evaluate + "\n__p+='"; + } + + // Adobe VMs need the match returned to produce the correct offest. + return match; + }); + source += "';\n"; + + // If a variable is not specified, place data values in local scope. + if (!settings.variable) source = 'with(obj||{}){\n' + source + '}\n'; + + source = "var __t,__p='',__j=Array.prototype.join," + + "print=function(){__p+=__j.call(arguments,'');};\n" + + source + 'return __p;\n'; + + try { + var render = new Function(settings.variable || 'obj', '_', source); + } catch (e) { + e.source = source; + throw e; + } + + var template = function(data) { + return render.call(this, data, _); + }; + + // Provide the compiled source as a convenience for precompilation. + var argument = settings.variable || 'obj'; + template.source = 'function(' + argument + '){\n' + source + '}'; + + return template; + }; + + // Add a "chain" function. Start chaining a wrapped Underscore object. + _.chain = function(obj) { + var instance = _(obj); + instance._chain = true; + return instance; + }; + + // OOP + // --------------- + // If Underscore is called as a function, it returns a wrapped object that + // can be used OO-style. This wrapper holds altered versions of all the + // underscore functions. Wrapped objects may be chained. + + // Helper function to continue chaining intermediate results. + var result = function(instance, obj) { + return instance._chain ? _(obj).chain() : obj; + }; + + // Add your own custom functions to the Underscore object. + _.mixin = function(obj) { + _.each(_.functions(obj), function(name) { + var func = _[name] = obj[name]; + _.prototype[name] = function() { + var args = [this._wrapped]; + push.apply(args, arguments); + return result(this, func.apply(_, args)); + }; + }); + }; + + // Add all of the Underscore functions to the wrapper object. + _.mixin(_); + + // Add all mutator Array functions to the wrapper. + _.each(['pop', 'push', 'reverse', 'shift', 'sort', 'splice', 'unshift'], function(name) { + var method = ArrayProto[name]; + _.prototype[name] = function() { + var obj = this._wrapped; + method.apply(obj, arguments); + if ((name === 'shift' || name === 'splice') && obj.length === 0) delete obj[0]; + return result(this, obj); + }; + }); + + // Add all accessor Array functions to the wrapper. + _.each(['concat', 'join', 'slice'], function(name) { + var method = ArrayProto[name]; + _.prototype[name] = function() { + return result(this, method.apply(this._wrapped, arguments)); + }; + }); + + // Extracts the result from a wrapped and chained object. + _.prototype.value = function() { + return this._wrapped; + }; + + // Provide unwrapping proxy for some methods used in engine operations + // such as arithmetic and JSON stringification. + _.prototype.valueOf = _.prototype.toJSON = _.prototype.value; + + _.prototype.toString = function() { + return '' + this._wrapped; + }; + + // AMD registration happens at the end for compatibility with AMD loaders + // that may not enforce next-turn semantics on modules. Even though general + // practice for AMD registration is to be anonymous, underscore registers + // as a named module because, like jQuery, it is a base library that is + // popular enough to be bundled in a third party lib, but not be part of + // an AMD load request. Those cases could generate an error when an + // anonymous define() is called outside of a loader request. + if (typeof define === 'function' && define.amd) { + define('underscore', [], function() { + return _; + }); + } +}.call(this)); + +},{}],26:[function(require,module,exports){ +arguments[4][19][0].apply(exports,arguments) +},{"dup":19}],27:[function(require,module,exports){ +module.exports = function isBuffer(arg) { + return arg && typeof arg === 'object' + && typeof arg.copy === 'function' + && typeof arg.fill === 'function' + && typeof arg.readUInt8 === 'function'; +} +},{}],28:[function(require,module,exports){ +(function (process,global){ +// Copyright Joyent, Inc. and other Node contributors. +// +// Permission is hereby granted, free of charge, to any person obtaining a +// copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to permit +// persons to whom the Software is furnished to do so, subject to the +// following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +// USE OR OTHER DEALINGS IN THE SOFTWARE. + +var formatRegExp = /%[sdj%]/g; +exports.format = function(f) { + if (!isString(f)) { + var objects = []; + for (var i = 0; i < arguments.length; i++) { + objects.push(inspect(arguments[i])); + } + return objects.join(' '); + } + + var i = 1; + var args = arguments; + var len = args.length; + var str = String(f).replace(formatRegExp, function(x) { + if (x === '%%') return '%'; + if (i >= len) return x; + switch (x) { + case '%s': return String(args[i++]); + case '%d': return Number(args[i++]); + case '%j': + try { + return JSON.stringify(args[i++]); + } catch (_) { + return '[Circular]'; + } + default: + return x; + } + }); + for (var x = args[i]; i < len; x = args[++i]) { + if (isNull(x) || !isObject(x)) { + str += ' ' + x; + } else { + str += ' ' + inspect(x); + } + } + return str; +}; + + +// Mark that a method should not be used. +// Returns a modified function which warns once by default. +// If --no-deprecation is set, then it is a no-op. +exports.deprecate = function(fn, msg) { + // Allow for deprecating things in the process of starting up. + if (isUndefined(global.process)) { + return function() { + return exports.deprecate(fn, msg).apply(this, arguments); + }; + } + + if (process.noDeprecation === true) { + return fn; + } + + var warned = false; + function deprecated() { + if (!warned) { + if (process.throwDeprecation) { + throw new Error(msg); + } else if (process.traceDeprecation) { + console.trace(msg); + } else { + console.error(msg); + } + warned = true; + } + return fn.apply(this, arguments); + } + + return deprecated; +}; + + +var debugs = {}; +var debugEnviron; +exports.debuglog = function(set) { + if (isUndefined(debugEnviron)) + debugEnviron = process.env.NODE_DEBUG || ''; + set = set.toUpperCase(); + if (!debugs[set]) { + if (new RegExp('\\b' + set + '\\b', 'i').test(debugEnviron)) { + var pid = process.pid; + debugs[set] = function() { + var msg = exports.format.apply(exports, arguments); + console.error('%s %d: %s', set, pid, msg); + }; + } else { + debugs[set] = function() {}; + } + } + return debugs[set]; +}; + + +/** + * Echos the value of a value. Trys to print the value out + * in the best way possible given the different types. + * + * @param {Object} obj The object to print out. + * @param {Object} opts Optional options object that alters the output. + */ +/* legacy: obj, showHidden, depth, colors*/ +function inspect(obj, opts) { + // default options + var ctx = { + seen: [], + stylize: stylizeNoColor + }; + // legacy... + if (arguments.length >= 3) ctx.depth = arguments[2]; + if (arguments.length >= 4) ctx.colors = arguments[3]; + if (isBoolean(opts)) { + // legacy... + ctx.showHidden = opts; + } else if (opts) { + // got an "options" object + exports._extend(ctx, opts); + } + // set default options + if (isUndefined(ctx.showHidden)) ctx.showHidden = false; + if (isUndefined(ctx.depth)) ctx.depth = 2; + if (isUndefined(ctx.colors)) ctx.colors = false; + if (isUndefined(ctx.customInspect)) ctx.customInspect = true; + if (ctx.colors) ctx.stylize = stylizeWithColor; + return formatValue(ctx, obj, ctx.depth); +} +exports.inspect = inspect; + + +// http://en.wikipedia.org/wiki/ANSI_escape_code#graphics +inspect.colors = { + 'bold' : [1, 22], + 'italic' : [3, 23], + 'underline' : [4, 24], + 'inverse' : [7, 27], + 'white' : [37, 39], + 'grey' : [90, 39], + 'black' : [30, 39], + 'blue' : [34, 39], + 'cyan' : [36, 39], + 'green' : [32, 39], + 'magenta' : [35, 39], + 'red' : [31, 39], + 'yellow' : [33, 39] +}; + +// Don't use 'blue' not visible on cmd.exe +inspect.styles = { + 'special': 'cyan', + 'number': 'yellow', + 'boolean': 'yellow', + 'undefined': 'grey', + 'null': 'bold', + 'string': 'green', + 'date': 'magenta', + // "name": intentionally not styling + 'regexp': 'red' +}; + + +function stylizeWithColor(str, styleType) { + var style = inspect.styles[styleType]; + + if (style) { + return '\u001b[' + inspect.colors[style][0] + 'm' + str + + '\u001b[' + inspect.colors[style][1] + 'm'; + } else { + return str; + } +} + + +function stylizeNoColor(str, styleType) { + return str; +} + + +function arrayToHash(array) { + var hash = {}; + + array.forEach(function(val, idx) { + hash[val] = true; + }); + + return hash; +} + + +function formatValue(ctx, value, recurseTimes) { + // Provide a hook for user-specified inspect functions. + // Check that value is an object with an inspect function on it + if (ctx.customInspect && + value && + isFunction(value.inspect) && + // Filter out the util module, it's inspect function is special + value.inspect !== exports.inspect && + // Also filter out any prototype objects using the circular check. + !(value.constructor && value.constructor.prototype === value)) { + var ret = value.inspect(recurseTimes, ctx); + if (!isString(ret)) { + ret = formatValue(ctx, ret, recurseTimes); + } + return ret; + } + + // Primitive types cannot have properties + var primitive = formatPrimitive(ctx, value); + if (primitive) { + return primitive; + } + + // Look up the keys of the object. + var keys = Object.keys(value); + var visibleKeys = arrayToHash(keys); + + if (ctx.showHidden) { + keys = Object.getOwnPropertyNames(value); + } + + // IE doesn't make error fields non-enumerable + // http://msdn.microsoft.com/en-us/library/ie/dww52sbt(v=vs.94).aspx + if (isError(value) + && (keys.indexOf('message') >= 0 || keys.indexOf('description') >= 0)) { + return formatError(value); + } + + // Some type of object without properties can be shortcutted. + if (keys.length === 0) { + if (isFunction(value)) { + var name = value.name ? ': ' + value.name : ''; + return ctx.stylize('[Function' + name + ']', 'special'); + } + if (isRegExp(value)) { + return ctx.stylize(RegExp.prototype.toString.call(value), 'regexp'); + } + if (isDate(value)) { + return ctx.stylize(Date.prototype.toString.call(value), 'date'); + } + if (isError(value)) { + return formatError(value); + } + } + + var base = '', array = false, braces = ['{', '}']; + + // Make Array say that they are Array + if (isArray(value)) { + array = true; + braces = ['[', ']']; + } + + // Make functions say that they are functions + if (isFunction(value)) { + var n = value.name ? ': ' + value.name : ''; + base = ' [Function' + n + ']'; + } + + // Make RegExps say that they are RegExps + if (isRegExp(value)) { + base = ' ' + RegExp.prototype.toString.call(value); + } + + // Make dates with properties first say the date + if (isDate(value)) { + base = ' ' + Date.prototype.toUTCString.call(value); + } + + // Make error with message first say the error + if (isError(value)) { + base = ' ' + formatError(value); + } + + if (keys.length === 0 && (!array || value.length == 0)) { + return braces[0] + base + braces[1]; + } + + if (recurseTimes < 0) { + if (isRegExp(value)) { + return ctx.stylize(RegExp.prototype.toString.call(value), 'regexp'); + } else { + return ctx.stylize('[Object]', 'special'); + } + } + + ctx.seen.push(value); + + var output; + if (array) { + output = formatArray(ctx, value, recurseTimes, visibleKeys, keys); + } else { + output = keys.map(function(key) { + return formatProperty(ctx, value, recurseTimes, visibleKeys, key, array); + }); + } + + ctx.seen.pop(); + + return reduceToSingleString(output, base, braces); +} + + +function formatPrimitive(ctx, value) { + if (isUndefined(value)) + return ctx.stylize('undefined', 'undefined'); + if (isString(value)) { + var simple = '\'' + JSON.stringify(value).replace(/^"|"$/g, '') + .replace(/'/g, "\\'") + .replace(/\\"/g, '"') + '\''; + return ctx.stylize(simple, 'string'); + } + if (isNumber(value)) + return ctx.stylize('' + value, 'number'); + if (isBoolean(value)) + return ctx.stylize('' + value, 'boolean'); + // For some reason typeof null is "object", so special case here. + if (isNull(value)) + return ctx.stylize('null', 'null'); +} + + +function formatError(value) { + return '[' + Error.prototype.toString.call(value) + ']'; +} + + +function formatArray(ctx, value, recurseTimes, visibleKeys, keys) { + var output = []; + for (var i = 0, l = value.length; i < l; ++i) { + if (hasOwnProperty(value, String(i))) { + output.push(formatProperty(ctx, value, recurseTimes, visibleKeys, + String(i), true)); + } else { + output.push(''); + } + } + keys.forEach(function(key) { + if (!key.match(/^\d+$/)) { + output.push(formatProperty(ctx, value, recurseTimes, visibleKeys, + key, true)); + } + }); + return output; +} + + +function formatProperty(ctx, value, recurseTimes, visibleKeys, key, array) { + var name, str, desc; + desc = Object.getOwnPropertyDescriptor(value, key) || { value: value[key] }; + if (desc.get) { + if (desc.set) { + str = ctx.stylize('[Getter/Setter]', 'special'); + } else { + str = ctx.stylize('[Getter]', 'special'); + } + } else { + if (desc.set) { + str = ctx.stylize('[Setter]', 'special'); + } + } + if (!hasOwnProperty(visibleKeys, key)) { + name = '[' + key + ']'; + } + if (!str) { + if (ctx.seen.indexOf(desc.value) < 0) { + if (isNull(recurseTimes)) { + str = formatValue(ctx, desc.value, null); + } else { + str = formatValue(ctx, desc.value, recurseTimes - 1); + } + if (str.indexOf('\n') > -1) { + if (array) { + str = str.split('\n').map(function(line) { + return ' ' + line; + }).join('\n').substr(2); + } else { + str = '\n' + str.split('\n').map(function(line) { + return ' ' + line; + }).join('\n'); + } + } + } else { + str = ctx.stylize('[Circular]', 'special'); + } + } + if (isUndefined(name)) { + if (array && key.match(/^\d+$/)) { + return str; + } + name = JSON.stringify('' + key); + if (name.match(/^"([a-zA-Z_][a-zA-Z_0-9]*)"$/)) { + name = name.substr(1, name.length - 2); + name = ctx.stylize(name, 'name'); + } else { + name = name.replace(/'/g, "\\'") + .replace(/\\"/g, '"') + .replace(/(^"|"$)/g, "'"); + name = ctx.stylize(name, 'string'); + } + } + + return name + ': ' + str; +} + + +function reduceToSingleString(output, base, braces) { + var numLinesEst = 0; + var length = output.reduce(function(prev, cur) { + numLinesEst++; + if (cur.indexOf('\n') >= 0) numLinesEst++; + return prev + cur.replace(/\u001b\[\d\d?m/g, '').length + 1; + }, 0); + + if (length > 60) { + return braces[0] + + (base === '' ? '' : base + '\n ') + + ' ' + + output.join(',\n ') + + ' ' + + braces[1]; + } + + return braces[0] + base + ' ' + output.join(', ') + ' ' + braces[1]; +} + + +// NOTE: These type checking functions intentionally don't use `instanceof` +// because it is fragile and can be easily faked with `Object.create()`. +function isArray(ar) { + return Array.isArray(ar); +} +exports.isArray = isArray; + +function isBoolean(arg) { + return typeof arg === 'boolean'; +} +exports.isBoolean = isBoolean; + +function isNull(arg) { + return arg === null; +} +exports.isNull = isNull; + +function isNullOrUndefined(arg) { + return arg == null; +} +exports.isNullOrUndefined = isNullOrUndefined; + +function isNumber(arg) { + return typeof arg === 'number'; +} +exports.isNumber = isNumber; + +function isString(arg) { + return typeof arg === 'string'; +} +exports.isString = isString; + +function isSymbol(arg) { + return typeof arg === 'symbol'; +} +exports.isSymbol = isSymbol; + +function isUndefined(arg) { + return arg === void 0; +} +exports.isUndefined = isUndefined; + +function isRegExp(re) { + return isObject(re) && objectToString(re) === '[object RegExp]'; +} +exports.isRegExp = isRegExp; + +function isObject(arg) { + return typeof arg === 'object' && arg !== null; +} +exports.isObject = isObject; + +function isDate(d) { + return isObject(d) && objectToString(d) === '[object Date]'; +} +exports.isDate = isDate; + +function isError(e) { + return isObject(e) && + (objectToString(e) === '[object Error]' || e instanceof Error); +} +exports.isError = isError; + +function isFunction(arg) { + return typeof arg === 'function'; +} +exports.isFunction = isFunction; + +function isPrimitive(arg) { + return arg === null || + typeof arg === 'boolean' || + typeof arg === 'number' || + typeof arg === 'string' || + typeof arg === 'symbol' || // ES6 symbol + typeof arg === 'undefined'; +} +exports.isPrimitive = isPrimitive; + +exports.isBuffer = require('./support/isBuffer'); + +function objectToString(o) { + return Object.prototype.toString.call(o); +} + + +function pad(n) { + return n < 10 ? '0' + n.toString(10) : n.toString(10); +} + + +var months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', + 'Oct', 'Nov', 'Dec']; + +// 26 Feb 16:19:34 +function timestamp() { + var d = new Date(); + var time = [pad(d.getHours()), + pad(d.getMinutes()), + pad(d.getSeconds())].join(':'); + return [d.getDate(), months[d.getMonth()], time].join(' '); +} + + +// log is just a thin wrapper to console.log that prepends a timestamp +exports.log = function() { + console.log('%s - %s', timestamp(), exports.format.apply(exports, arguments)); +}; + + +/** + * Inherit the prototype methods from one constructor into another. + * + * The Function.prototype.inherits from lang.js rewritten as a standalone + * function (not on Function.prototype). NOTE: If this file is to be loaded + * during bootstrapping this function needs to be rewritten using some native + * functions as prototype setup using normal JavaScript does not work as + * expected during bootstrapping (see mirror.js in r114903). + * + * @param {function} ctor Constructor function which needs to inherit the + * prototype. + * @param {function} superCtor Constructor function to inherit prototype from. + */ +exports.inherits = require('inherits'); + +exports._extend = function(origin, add) { + // Don't do anything if add isn't an object + if (!add || !isObject(add)) return origin; + + var keys = Object.keys(add); + var i = keys.length; + while (i--) { + origin[keys[i]] = add[keys[i]]; + } + return origin; +}; + +function hasOwnProperty(obj, prop) { + return Object.prototype.hasOwnProperty.call(obj, prop); +} + +}).call(this,require('_process'),typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : typeof window !== "undefined" ? window : {}) +},{"./support/isBuffer":27,"_process":24,"inherits":26}],29:[function(require,module,exports){ +// Returns a wrapper function that returns a wrapped callback +// The wrapper function should do some stuff, and return a +// presumably different callback function. +// This makes sure that own properties are retained, so that +// decorations and such are not lost along the way. +module.exports = wrappy +function wrappy (fn, cb) { + if (fn && cb) return wrappy(fn)(cb) + + if (typeof fn !== 'function') + throw new TypeError('need wrapper function') + + Object.keys(fn).forEach(function (k) { + wrapper[k] = fn[k] + }) + + return wrapper + + function wrapper() { + var args = new Array(arguments.length) + for (var i = 0; i < args.length; i++) { + args[i] = arguments[i] + } + var ret = fn.apply(this, args) + var cb = args[args.length-1] + if (typeof ret === 'function' && ret !== cb) { + Object.keys(cb).forEach(function (k) { + ret[k] = cb[k] + }) + } + return ret + } +} + +},{}]},{},[7])(7) +}); \ No newline at end of file diff --git a/assets/javascripts/workers/search.1e90e0fb.min.js b/assets/javascripts/workers/search.1e90e0fb.min.js new file mode 100644 index 00000000..ff43aedd --- /dev/null +++ b/assets/javascripts/workers/search.1e90e0fb.min.js @@ -0,0 +1,2 @@ +"use strict";(()=>{var xe=Object.create;var G=Object.defineProperty,ve=Object.defineProperties,Se=Object.getOwnPropertyDescriptor,Te=Object.getOwnPropertyDescriptors,Qe=Object.getOwnPropertyNames,Y=Object.getOwnPropertySymbols,Ee=Object.getPrototypeOf,X=Object.prototype.hasOwnProperty,be=Object.prototype.propertyIsEnumerable;var Z=Math.pow,J=(t,e,r)=>e in t?G(t,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[e]=r,_=(t,e)=>{for(var r in e||(e={}))X.call(e,r)&&J(t,r,e[r]);if(Y)for(var r of Y(e))be.call(e,r)&&J(t,r,e[r]);return t},B=(t,e)=>ve(t,Te(e));var Le=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports);var we=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of Qe(e))!X.call(t,i)&&i!==r&&G(t,i,{get:()=>e[i],enumerable:!(n=Se(e,i))||n.enumerable});return t};var Pe=(t,e,r)=>(r=t!=null?xe(Ee(t)):{},we(e||!t||!t.__esModule?G(r,"default",{value:t,enumerable:!0}):r,t));var W=(t,e,r)=>new Promise((n,i)=>{var s=u=>{try{a(r.next(u))}catch(c){i(c)}},o=u=>{try{a(r.throw(u))}catch(c){i(c)}},a=u=>u.done?n(u.value):Promise.resolve(u.value).then(s,o);a((r=r.apply(t,e)).next())});var te=Le((K,ee)=>{(function(){var t=function(e){var r=new t.Builder;return r.pipeline.add(t.trimmer,t.stopWordFilter,t.stemmer),r.searchPipeline.add(t.stemmer),e.call(r,r),r.build()};t.version="2.3.9";t.utils={},t.utils.warn=function(e){return function(r){e.console&&console.warn&&console.warn(r)}}(this),t.utils.asString=function(e){return e==null?"":e.toString()},t.utils.clone=function(e){if(e==null)return e;for(var r=Object.create(null),n=Object.keys(e),i=0;i0){var f=t.utils.clone(r)||{};f.position=[a,c],f.index=s.length,s.push(new t.Token(n.slice(a,o),f))}a=o+1}}return s},t.tokenizer.separator=/[\s\-]+/;t.Pipeline=function(){this._stack=[]},t.Pipeline.registeredFunctions=Object.create(null),t.Pipeline.registerFunction=function(e,r){r in this.registeredFunctions&&t.utils.warn("Overwriting existing registered function: "+r),e.label=r,t.Pipeline.registeredFunctions[e.label]=e},t.Pipeline.warnIfFunctionNotRegistered=function(e){var r=e.label&&e.label in this.registeredFunctions;r||t.utils.warn(`Function is not registered with pipeline. This may cause problems when serialising the index. +`,e)},t.Pipeline.load=function(e){var r=new t.Pipeline;return e.forEach(function(n){var i=t.Pipeline.registeredFunctions[n];if(i)r.add(i);else throw new Error("Cannot load unregistered function: "+n)}),r},t.Pipeline.prototype.add=function(){var e=Array.prototype.slice.call(arguments);e.forEach(function(r){t.Pipeline.warnIfFunctionNotRegistered(r),this._stack.push(r)},this)},t.Pipeline.prototype.after=function(e,r){t.Pipeline.warnIfFunctionNotRegistered(r);var n=this._stack.indexOf(e);if(n==-1)throw new Error("Cannot find existingFn");n=n+1,this._stack.splice(n,0,r)},t.Pipeline.prototype.before=function(e,r){t.Pipeline.warnIfFunctionNotRegistered(r);var n=this._stack.indexOf(e);if(n==-1)throw new Error("Cannot find existingFn");this._stack.splice(n,0,r)},t.Pipeline.prototype.remove=function(e){var r=this._stack.indexOf(e);r!=-1&&this._stack.splice(r,1)},t.Pipeline.prototype.run=function(e){for(var r=this._stack.length,n=0;n1&&(oe&&(n=s),o!=e);)i=n-r,s=r+Math.floor(i/2),o=this.elements[s*2];if(o==e||o>e)return s*2;if(ou?f+=2:a==u&&(r+=n[c+1]*i[f+1],c+=2,f+=2);return r},t.Vector.prototype.similarity=function(e){return this.dot(e)/this.magnitude()||0},t.Vector.prototype.toArray=function(){for(var e=new Array(this.elements.length/2),r=1,n=0;r0){var o=s.str.charAt(0),a;o in s.node.edges?a=s.node.edges[o]:(a=new t.TokenSet,s.node.edges[o]=a),s.str.length==1&&(a.final=!0),i.push({node:a,editsRemaining:s.editsRemaining,str:s.str.slice(1)})}if(s.editsRemaining!=0){if("*"in s.node.edges)var u=s.node.edges["*"];else{var u=new t.TokenSet;s.node.edges["*"]=u}if(s.str.length==0&&(u.final=!0),i.push({node:u,editsRemaining:s.editsRemaining-1,str:s.str}),s.str.length>1&&i.push({node:s.node,editsRemaining:s.editsRemaining-1,str:s.str.slice(1)}),s.str.length==1&&(s.node.final=!0),s.str.length>=1){if("*"in s.node.edges)var c=s.node.edges["*"];else{var c=new t.TokenSet;s.node.edges["*"]=c}s.str.length==1&&(c.final=!0),i.push({node:c,editsRemaining:s.editsRemaining-1,str:s.str.slice(1)})}if(s.str.length>1){var f=s.str.charAt(0),g=s.str.charAt(1),l;g in s.node.edges?l=s.node.edges[g]:(l=new t.TokenSet,s.node.edges[g]=l),s.str.length==1&&(l.final=!0),i.push({node:l,editsRemaining:s.editsRemaining-1,str:f+s.str.slice(2)})}}}return n},t.TokenSet.fromString=function(e){for(var r=new t.TokenSet,n=r,i=0,s=e.length;i=e;r--){var n=this.uncheckedNodes[r],i=n.child.toString();i in this.minimizedNodes?n.parent.edges[n.char]=this.minimizedNodes[i]:(n.child._str=i,this.minimizedNodes[i]=n.child),this.uncheckedNodes.pop()}};t.Index=function(e){this.invertedIndex=e.invertedIndex,this.fieldVectors=e.fieldVectors,this.tokenSet=e.tokenSet,this.fields=e.fields,this.pipeline=e.pipeline},t.Index.prototype.search=function(e){return this.query(function(r){var n=new t.QueryParser(e,r);n.parse()})},t.Index.prototype.query=function(e){for(var r=new t.Query(this.fields),n=Object.create(null),i=Object.create(null),s=Object.create(null),o=Object.create(null),a=Object.create(null),u=0;u1?this._b=1:this._b=e},t.Builder.prototype.k1=function(e){this._k1=e},t.Builder.prototype.add=function(e,r){var n=e[this._ref],i=Object.keys(this._fields);this._documents[n]=r||{},this.documentCount+=1;for(var s=0;s=this.length)return t.QueryLexer.EOS;var e=this.str.charAt(this.pos);return this.pos+=1,e},t.QueryLexer.prototype.width=function(){return this.pos-this.start},t.QueryLexer.prototype.ignore=function(){this.start==this.pos&&(this.pos+=1),this.start=this.pos},t.QueryLexer.prototype.backup=function(){this.pos-=1},t.QueryLexer.prototype.acceptDigitRun=function(){var e,r;do e=this.next(),r=e.charCodeAt(0);while(r>47&&r<58);e!=t.QueryLexer.EOS&&this.backup()},t.QueryLexer.prototype.more=function(){return this.pos1&&(e.backup(),e.emit(t.QueryLexer.TERM)),e.ignore(),e.more())return t.QueryLexer.lexText},t.QueryLexer.lexEditDistance=function(e){return e.ignore(),e.acceptDigitRun(),e.emit(t.QueryLexer.EDIT_DISTANCE),t.QueryLexer.lexText},t.QueryLexer.lexBoost=function(e){return e.ignore(),e.acceptDigitRun(),e.emit(t.QueryLexer.BOOST),t.QueryLexer.lexText},t.QueryLexer.lexEOS=function(e){e.width()>0&&e.emit(t.QueryLexer.TERM)},t.QueryLexer.termSeparator=t.tokenizer.separator,t.QueryLexer.lexText=function(e){for(;;){var r=e.next();if(r==t.QueryLexer.EOS)return t.QueryLexer.lexEOS;if(r.charCodeAt(0)==92){e.escapeCharacter();continue}if(r==":")return t.QueryLexer.lexField;if(r=="~")return e.backup(),e.width()>0&&e.emit(t.QueryLexer.TERM),t.QueryLexer.lexEditDistance;if(r=="^")return e.backup(),e.width()>0&&e.emit(t.QueryLexer.TERM),t.QueryLexer.lexBoost;if(r=="+"&&e.width()===1||r=="-"&&e.width()===1)return e.emit(t.QueryLexer.PRESENCE),t.QueryLexer.lexText;if(r.match(t.QueryLexer.termSeparator))return t.QueryLexer.lexTerm}},t.QueryParser=function(e,r){this.lexer=new t.QueryLexer(e),this.query=r,this.currentClause={},this.lexemeIdx=0},t.QueryParser.prototype.parse=function(){this.lexer.run(),this.lexemes=this.lexer.lexemes;for(var e=t.QueryParser.parseClause;e;)e=e(this);return this.query},t.QueryParser.prototype.peekLexeme=function(){return this.lexemes[this.lexemeIdx]},t.QueryParser.prototype.consumeLexeme=function(){var e=this.peekLexeme();return this.lexemeIdx+=1,e},t.QueryParser.prototype.nextClause=function(){var e=this.currentClause;this.query.clause(e),this.currentClause={}},t.QueryParser.parseClause=function(e){var r=e.peekLexeme();if(r!=null)switch(r.type){case t.QueryLexer.PRESENCE:return t.QueryParser.parsePresence;case t.QueryLexer.FIELD:return t.QueryParser.parseField;case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var n="expected either a field or a term, found "+r.type;throw r.str.length>=1&&(n+=" with value '"+r.str+"'"),new t.QueryParseError(n,r.start,r.end)}},t.QueryParser.parsePresence=function(e){var r=e.consumeLexeme();if(r!=null){switch(r.str){case"-":e.currentClause.presence=t.Query.presence.PROHIBITED;break;case"+":e.currentClause.presence=t.Query.presence.REQUIRED;break;default:var n="unrecognised presence operator'"+r.str+"'";throw new t.QueryParseError(n,r.start,r.end)}var i=e.peekLexeme();if(i==null){var n="expecting term or field, found nothing";throw new t.QueryParseError(n,r.start,r.end)}switch(i.type){case t.QueryLexer.FIELD:return t.QueryParser.parseField;case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var n="expecting term or field, found '"+i.type+"'";throw new t.QueryParseError(n,i.start,i.end)}}},t.QueryParser.parseField=function(e){var r=e.consumeLexeme();if(r!=null){if(e.query.allFields.indexOf(r.str)==-1){var n=e.query.allFields.map(function(o){return"'"+o+"'"}).join(", "),i="unrecognised field '"+r.str+"', possible fields: "+n;throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.fields=[r.str];var s=e.peekLexeme();if(s==null){var i="expecting term, found nothing";throw new t.QueryParseError(i,r.start,r.end)}switch(s.type){case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var i="expecting term, found '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},t.QueryParser.parseTerm=function(e){var r=e.consumeLexeme();if(r!=null){e.currentClause.term=r.str.toLowerCase(),r.str.indexOf("*")!=-1&&(e.currentClause.usePipeline=!1);var n=e.peekLexeme();if(n==null){e.nextClause();return}switch(n.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+n.type+"'";throw new t.QueryParseError(i,n.start,n.end)}}},t.QueryParser.parseEditDistance=function(e){var r=e.consumeLexeme();if(r!=null){var n=parseInt(r.str,10);if(isNaN(n)){var i="edit distance must be numeric";throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.editDistance=n;var s=e.peekLexeme();if(s==null){e.nextClause();return}switch(s.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},t.QueryParser.parseBoost=function(e){var r=e.consumeLexeme();if(r!=null){var n=parseInt(r.str,10);if(isNaN(n)){var i="boost must be numeric";throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.boost=n;var s=e.peekLexeme();if(s==null){e.nextClause();return}switch(s.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},function(e,r){typeof define=="function"&&define.amd?define(r):typeof K=="object"?ee.exports=r():e.lunr=r()}(this,function(){return t})})()});var de=Pe(te());function re(t,e=document){let r=ke(t,e);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${t}" to be present`);return r}function ke(t,e=document){return e.querySelector(t)||void 0}Object.entries||(Object.entries=function(t){let e=[];for(let r of Object.keys(t))e.push([r,t[r]]);return e});Object.values||(Object.values=function(t){let e=[];for(let r of Object.keys(t))e.push(t[r]);return e});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(t,e){typeof t=="object"?(this.scrollLeft=t.left,this.scrollTop=t.top):(this.scrollLeft=t,this.scrollTop=e)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...t){let e=this.parentNode;if(e){t.length===0&&e.removeChild(this);for(let r=t.length-1;r>=0;r--){let n=t[r];typeof n=="string"?n=document.createTextNode(n):n.parentNode&&n.parentNode.removeChild(n),r?e.insertBefore(this.previousSibling,n):e.replaceChild(n,this)}}}));function ne(t){let e=new Map;for(let r of t){let[n]=r.location.split("#"),i=e.get(n);typeof i=="undefined"?e.set(n,r):(e.set(r.location,r),r.parent=i)}return e}function H(t,e,r){var s;e=new RegExp(e,"g");let n,i=0;do{n=e.exec(t);let o=(s=n==null?void 0:n.index)!=null?s:t.length;if(in?e(r,1,n,n=i):t.charAt(i)===">"&&(t.charAt(n+1)==="/"?--s===0&&e(r++,2,n,i+1):t.charAt(i-1)!=="/"&&s++===0&&e(r,0,n,i+1),n=i+1);i>n&&e(r,1,n,i)}function se(t,e,r,n=!1){return q([t],e,r,n).pop()}function q(t,e,r,n=!1){let i=[0];for(let s=1;s>>2&1023,c=a[0]>>>12;i.push(+(u>c)+i[i.length-1])}return t.map((s,o)=>{let a=0,u=new Map;for(let f of r.sort((g,l)=>g-l)){let g=f&1048575,l=f>>>20;if(i[l]!==o)continue;let m=u.get(l);typeof m=="undefined"&&u.set(l,m=[]),m.push(g)}if(u.size===0)return s;let c=[];for(let[f,g]of u){let l=e[f],m=l[0]>>>12,x=l[l.length-1]>>>12,v=l[l.length-1]>>>2&1023;n&&m>a&&c.push(s.slice(a,m));let d=s.slice(m,x+v);for(let y of g.sort((b,E)=>E-b)){let b=(l[y]>>>12)-m,E=(l[y]>>>2&1023)+b;d=[d.slice(0,b),"",d.slice(b,E),"",d.slice(E)].join("")}if(a=x+v,c.push(d)===2)break}return n&&a{var f;switch(i[f=o+=s]||(i[f]=[]),a){case 0:case 2:i[o].push(u<<12|c-u<<2|a);break;case 1:let g=r[n].slice(u,c);H(g,lunr.tokenizer.separator,(l,m)=>{if(typeof lunr.segmenter!="undefined"){let x=g.slice(l,m);if(/^[MHIK]$/.test(lunr.segmenter.ctype_(x))){let v=lunr.segmenter.segment(x);for(let d=0,y=0;dr){return t.trim().split(/"([^"]+)"/g).map((r,n)=>n&1?r.replace(/^\b|^(?![^\x00-\x7F]|$)|\s+/g," +"):r).join("").replace(/"|(?:^|\s+)[*+\-:^~]+(?=\s+|$)/g,"").split(/\s+/g).reduce((r,n)=>{let i=e(n);return[...r,...Array.isArray(i)?i:[i]]},[]).map(r=>/([~^]$)/.test(r)?`${r}1`:r).map(r=>/(^[+-]|[~^]\d+$)/.test(r)?r:`${r}*`).join(" ")}function ue(t){return ae(t,e=>{let r=[],n=new lunr.QueryLexer(e);n.run();for(let{type:i,str:s,start:o,end:a}of n.lexemes)switch(i){case"FIELD":["title","text","tags"].includes(s)||(e=[e.slice(0,a)," ",e.slice(a+1)].join(""));break;case"TERM":H(s,lunr.tokenizer.separator,(...u)=>{r.push([e.slice(0,o),s.slice(...u),e.slice(a)].join(""))})}return r})}function ce(t){let e=new lunr.Query(["title","text","tags"]);new lunr.QueryParser(t,e).parse();for(let n of e.clauses)n.usePipeline=!0,n.term.startsWith("*")&&(n.wildcard=lunr.Query.wildcard.LEADING,n.term=n.term.slice(1)),n.term.endsWith("*")&&(n.wildcard=lunr.Query.wildcard.TRAILING,n.term=n.term.slice(0,-1));return e.clauses}function le(t,e){var i;let r=new Set(t),n={};for(let s=0;s0;){let o=i[--s];for(let u=1;un[o]-u&&(r.add(t.slice(o,o+u)),i[s++]=o+u);let a=o+n[o];n[a]&&ar=>{if(typeof r[e]=="undefined")return;let n=[r.location,e].join(":");return t.set(n,lunr.tokenizer.table=[]),r[e]}}function Re(t,e){let[r,n]=[new Set(t),new Set(e)];return[...new Set([...r].filter(i=>!n.has(i)))]}var U=class{constructor({config:e,docs:r,options:n}){let i=Oe(this.table=new Map);this.map=ne(r),this.options=n,this.index=lunr(function(){this.metadataWhitelist=["position"],this.b(0),e.lang.length===1&&e.lang[0]!=="en"?this.use(lunr[e.lang[0]]):e.lang.length>1&&this.use(lunr.multiLanguage(...e.lang)),this.tokenizer=oe,lunr.tokenizer.separator=new RegExp(e.separator),lunr.segmenter="TinySegmenter"in lunr?new lunr.TinySegmenter:void 0;let s=Re(["trimmer","stopWordFilter","stemmer"],e.pipeline);for(let o of e.lang.map(a=>a==="en"?lunr:lunr[a]))for(let a of s)this.pipeline.remove(o[a]),this.searchPipeline.remove(o[a]);this.ref("location");for(let[o,a]of Object.entries(e.fields))this.field(o,B(_({},a),{extractor:i(o)}));for(let o of r)this.add(o,{boost:o.boost})})}search(e){if(e=e.replace(new RegExp("\\p{sc=Han}+","gu"),s=>[...he(s,this.index.invertedIndex)].join("* ")),e=ue(e),!e)return{items:[]};let r=ce(e).filter(s=>s.presence!==lunr.Query.presence.PROHIBITED),n=this.index.search(e).reduce((s,{ref:o,score:a,matchData:u})=>{let c=this.map.get(o);if(typeof c!="undefined"){c=_({},c),c.tags&&(c.tags=[...c.tags]);let f=le(r,Object.keys(u.metadata));for(let l of this.index.fields){if(typeof c[l]=="undefined")continue;let m=[];for(let d of Object.values(u.metadata))typeof d[l]!="undefined"&&m.push(...d[l].position);if(!m.length)continue;let x=this.table.get([c.location,l].join(":")),v=Array.isArray(c[l])?q:se;c[l]=v(c[l],x,m,l!=="text")}let g=+!c.parent+Object.values(f).filter(l=>l).length/Object.keys(f).length;s.push(B(_({},c),{score:a*(1+Z(g,2)),terms:f}))}return s},[]).sort((s,o)=>o.score-s.score).reduce((s,o)=>{let a=this.map.get(o.location);if(typeof a!="undefined"){let u=a.parent?a.parent.location:a.location;s.set(u,[...s.get(u)||[],o])}return s},new Map);for(let[s,o]of n)if(!o.find(a=>a.location===s)){let a=this.map.get(s);o.push(B(_({},a),{score:0,terms:{}}))}let i;if(this.options.suggest){let s=this.index.query(o=>{for(let a of r)o.term(a.term,{fields:["title"],presence:lunr.Query.presence.REQUIRED,wildcard:lunr.Query.wildcard.TRAILING})});i=s.length?Object.keys(s[0].matchData.metadata):[]}return _({items:[...n.values()]},typeof i!="undefined"&&{suggest:i})}};var fe;function Ie(t){return W(this,null,function*(){let e="../lunr";if(typeof parent!="undefined"&&"IFrameWorker"in parent){let n=re("script[src]"),[i]=n.src.split("/worker");e=e.replace("..",i)}let r=[];for(let n of t.lang){switch(n){case"ja":r.push(`${e}/tinyseg.js`);break;case"hi":case"th":r.push(`${e}/wordcut.js`);break}n!=="en"&&r.push(`${e}/min/lunr.${n}.min.js`)}t.lang.length>1&&r.push(`${e}/min/lunr.multi.min.js`),r.length&&(yield importScripts(`${e}/min/lunr.stemmer.support.min.js`,...r))})}function Fe(t){return W(this,null,function*(){switch(t.type){case 0:return yield Ie(t.data.config),fe=new U(t.data),{type:1};case 2:let e=t.data;try{return{type:3,data:fe.search(e)}}catch(r){return console.warn(`Invalid query: ${e} \u2013 see https://bit.ly/2s3ChXG`),console.warn(r),{type:3,data:{items:[]}}}default:throw new TypeError("Invalid message type")}})}self.lunr=de.default;addEventListener("message",t=>W(void 0,null,function*(){postMessage(yield Fe(t.data))}));})(); diff --git a/assets/stylesheets/main.382dd0b9.min.css b/assets/stylesheets/main.382dd0b9.min.css new file mode 100644 index 00000000..5812f02e --- /dev/null +++ b/assets/stylesheets/main.382dd0b9.min.css @@ -0,0 +1 @@ +@charset "UTF-8";html{-webkit-text-size-adjust:none;-moz-text-size-adjust:none;text-size-adjust:none;box-sizing:border-box}*,:after,:before{box-sizing:inherit}@media (prefers-reduced-motion){*,:after,:before{transition:none!important}}body{margin:0}a,button,input,label{-webkit-tap-highlight-color:transparent}a{color:inherit;text-decoration:none}hr{border:0;box-sizing:initial;display:block;height:.05rem;overflow:visible;padding:0}small{font-size:80%}sub,sup{line-height:1em}img{border-style:none}table{border-collapse:initial;border-spacing:0}td,th{font-weight:400;vertical-align:top}button{background:#0000;border:0;font-family:inherit;font-size:inherit;margin:0;padding:0}input{border:0;outline:none}:root{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-scheme=default]{color-scheme:light}[data-md-color-scheme=default] img[src$="#gh-dark-mode-only"],[data-md-color-scheme=default] img[src$="#only-dark"]{display:none}:root,[data-md-color-scheme=default]{--md-hue:225deg;--md-default-fg-color:#000000de;--md-default-fg-color--light:#0000008a;--md-default-fg-color--lighter:#00000052;--md-default-fg-color--lightest:#00000012;--md-default-bg-color:#fff;--md-default-bg-color--light:#ffffffb3;--md-default-bg-color--lighter:#ffffff4d;--md-default-bg-color--lightest:#ffffff1f;--md-code-fg-color:#36464e;--md-code-bg-color:#f5f5f5;--md-code-bg-color--light:#f5f5f5b3;--md-code-bg-color--lighter:#f5f5f54d;--md-code-hl-color:#4287ff;--md-code-hl-color--light:#4287ff1a;--md-code-hl-number-color:#d52a2a;--md-code-hl-special-color:#db1457;--md-code-hl-function-color:#a846b9;--md-code-hl-constant-color:#6e59d9;--md-code-hl-keyword-color:#3f6ec6;--md-code-hl-string-color:#1c7d4d;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-del-color:#f5503d26;--md-typeset-ins-color:#0bd57026;--md-typeset-kbd-color:#fafafa;--md-typeset-kbd-accent-color:#fff;--md-typeset-kbd-border-color:#b8b8b8;--md-typeset-mark-color:#ffff0080;--md-typeset-table-color:#0000001f;--md-typeset-table-color--light:rgba(0,0,0,.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-warning-fg-color:#000000de;--md-warning-bg-color:#ff9;--md-footer-fg-color:#fff;--md-footer-fg-color--light:#ffffffb3;--md-footer-fg-color--lighter:#ffffff73;--md-footer-bg-color:#000000de;--md-footer-bg-color--dark:#00000052;--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #0000001a,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0003,0 0 0.05rem #00000059}.md-icon svg{fill:currentcolor;display:block;height:1.2rem;width:1.2rem}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;--md-text-font-family:var(--md-text-font,_),-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;--md-code-font-family:var(--md-code-font,_),SFMono-Regular,Consolas,Menlo,monospace}aside,body,input{font-feature-settings:"kern","liga";color:var(--md-typeset-color);font-family:var(--md-text-font-family)}code,kbd,pre{font-feature-settings:"kern";font-family:var(--md-code-font-family)}:root{--md-typeset-table-sort-icon:url('data:image/svg+xml;charset=utf-8,');--md-typeset-table-sort-icon--asc:url('data:image/svg+xml;charset=utf-8,');--md-typeset-table-sort-icon--desc:url('data:image/svg+xml;charset=utf-8,')}.md-typeset{-webkit-print-color-adjust:exact;color-adjust:exact;font-size:.8rem;line-height:1.6}@media print{.md-typeset{font-size:.68rem}}.md-typeset blockquote,.md-typeset dl,.md-typeset figure,.md-typeset ol,.md-typeset pre,.md-typeset ul{margin-bottom:1em;margin-top:1em}.md-typeset h1{color:var(--md-default-fg-color--light);font-size:2em;line-height:1.3;margin:0 0 1.25em}.md-typeset h1,.md-typeset h2{font-weight:300;letter-spacing:-.01em}.md-typeset h2{font-size:1.5625em;line-height:1.4;margin:1.6em 0 .64em}.md-typeset h3{font-size:1.25em;font-weight:400;letter-spacing:-.01em;line-height:1.5;margin:1.6em 0 .8em}.md-typeset h2+h3{margin-top:.8em}.md-typeset h4{font-weight:700;letter-spacing:-.01em;margin:1em 0}.md-typeset h5,.md-typeset h6{color:var(--md-default-fg-color--light);font-size:.8em;font-weight:700;letter-spacing:-.01em;margin:1.25em 0}.md-typeset h5{text-transform:uppercase}.md-typeset hr{border-bottom:.05rem solid var(--md-default-fg-color--lightest);display:flow-root;margin:1.5em 0}.md-typeset a{color:var(--md-typeset-a-color);word-break:break-word}.md-typeset a,.md-typeset a:before{transition:color 125ms}.md-typeset a:focus,.md-typeset a:hover{color:var(--md-accent-fg-color)}.md-typeset a:focus code,.md-typeset a:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset a code{color:var(--md-typeset-a-color)}.md-typeset a.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset code,.md-typeset kbd,.md-typeset pre{color:var(--md-code-fg-color);direction:ltr;font-variant-ligatures:none;transition:background-color 125ms}@media print{.md-typeset code,.md-typeset kbd,.md-typeset pre{white-space:pre-wrap}}.md-typeset code{background-color:var(--md-code-bg-color);border-radius:.1rem;-webkit-box-decoration-break:clone;box-decoration-break:clone;font-size:.85em;padding:0 .2941176471em;transition:color 125ms,background-color 125ms;word-break:break-word}.md-typeset code:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-typeset pre{display:flow-root;line-height:1.4;position:relative}.md-typeset pre>code{-webkit-box-decoration-break:slice;box-decoration-break:slice;box-shadow:none;display:block;margin:0;outline-color:var(--md-accent-fg-color);overflow:auto;padding:.7720588235em 1.1764705882em;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin;touch-action:auto;word-break:normal}.md-typeset pre>code:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-typeset pre>code::-webkit-scrollbar{height:.2rem;width:.2rem}.md-typeset pre>code::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-typeset pre>code::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}.md-typeset kbd{background-color:var(--md-typeset-kbd-color);border-radius:.1rem;box-shadow:0 .1rem 0 .05rem var(--md-typeset-kbd-border-color),0 .1rem 0 var(--md-typeset-kbd-border-color),0 -.1rem .2rem var(--md-typeset-kbd-accent-color) inset;color:var(--md-default-fg-color);display:inline-block;font-size:.75em;padding:0 .6666666667em;vertical-align:text-top;word-break:break-word}.md-typeset mark{background-color:var(--md-typeset-mark-color);-webkit-box-decoration-break:clone;box-decoration-break:clone;color:inherit;word-break:break-word}.md-typeset abbr{border-bottom:.05rem dotted var(--md-default-fg-color--light);cursor:help;text-decoration:none}.md-typeset small{opacity:.75}[dir=ltr] .md-typeset sub,[dir=ltr] .md-typeset sup{margin-left:.078125em}[dir=rtl] .md-typeset sub,[dir=rtl] .md-typeset sup{margin-right:.078125em}[dir=ltr] .md-typeset blockquote{padding-left:.6rem}[dir=rtl] .md-typeset blockquote{padding-right:.6rem}[dir=ltr] .md-typeset blockquote{border-left:.2rem solid var(--md-default-fg-color--lighter)}[dir=rtl] .md-typeset blockquote{border-right:.2rem solid var(--md-default-fg-color--lighter)}.md-typeset blockquote{color:var(--md-default-fg-color--light);margin-left:0;margin-right:0}.md-typeset ul{list-style-type:disc}[dir=ltr] .md-typeset ol,[dir=ltr] .md-typeset ul{margin-left:.625em}[dir=rtl] .md-typeset ol,[dir=rtl] .md-typeset ul{margin-right:.625em}.md-typeset ol,.md-typeset ul{padding:0}.md-typeset ol:not([hidden]),.md-typeset ul:not([hidden]){display:flow-root}.md-typeset ol ol,.md-typeset ul ol{list-style-type:lower-alpha}.md-typeset ol ol ol,.md-typeset ul ol ol{list-style-type:lower-roman}[dir=ltr] .md-typeset ol li,[dir=ltr] .md-typeset ul li{margin-left:1.25em}[dir=rtl] .md-typeset ol li,[dir=rtl] .md-typeset ul li{margin-right:1.25em}.md-typeset ol li,.md-typeset ul li{margin-bottom:.5em}.md-typeset ol li blockquote,.md-typeset ol li p,.md-typeset ul li blockquote,.md-typeset ul li p{margin:.5em 0}.md-typeset ol li:last-child,.md-typeset ul li:last-child{margin-bottom:0}[dir=ltr] .md-typeset ol li ol,[dir=ltr] .md-typeset ol li ul,[dir=ltr] .md-typeset ul li ol,[dir=ltr] .md-typeset ul li ul{margin-left:.625em}[dir=rtl] .md-typeset ol li ol,[dir=rtl] .md-typeset ol li ul,[dir=rtl] .md-typeset ul li ol,[dir=rtl] .md-typeset ul li ul{margin-right:.625em}.md-typeset ol li ol,.md-typeset ol li ul,.md-typeset ul li ol,.md-typeset ul li ul{margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset dd{margin-left:1.875em}[dir=rtl] .md-typeset dd{margin-right:1.875em}.md-typeset dd{margin-bottom:1.5em;margin-top:1em}.md-typeset img,.md-typeset svg,.md-typeset video{height:auto;max-width:100%}.md-typeset img[align=left]{margin:1em 1em 1em 0}.md-typeset img[align=right]{margin:1em 0 1em 1em}.md-typeset img[align]:only-child{margin-top:0}.md-typeset figure{display:flow-root;margin:1em auto;max-width:100%;text-align:center;width:-webkit-fit-content;width:-moz-fit-content;width:fit-content}.md-typeset figure img{display:block}.md-typeset figcaption{font-style:italic;margin:1em auto;max-width:24rem}.md-typeset iframe{max-width:100%}.md-typeset table:not([class]){background-color:var(--md-default-bg-color);border:.05rem solid var(--md-typeset-table-color);border-radius:.1rem;display:inline-block;font-size:.64rem;max-width:100%;overflow:auto;touch-action:auto}@media print{.md-typeset table:not([class]){display:table}}.md-typeset table:not([class])+*{margin-top:1.5em}.md-typeset table:not([class]) td>:first-child,.md-typeset table:not([class]) th>:first-child{margin-top:0}.md-typeset table:not([class]) td>:last-child,.md-typeset table:not([class]) th>:last-child{margin-bottom:0}.md-typeset table:not([class]) td:not([align]),.md-typeset table:not([class]) th:not([align]){text-align:left}[dir=rtl] .md-typeset table:not([class]) td:not([align]),[dir=rtl] .md-typeset table:not([class]) th:not([align]){text-align:right}.md-typeset table:not([class]) th{font-weight:700;min-width:5rem;padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) td{border-top:.05rem solid var(--md-typeset-table-color);padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) tbody tr{transition:background-color 125ms}.md-typeset table:not([class]) tbody tr:hover{background-color:var(--md-typeset-table-color--light);box-shadow:0 .05rem 0 var(--md-default-bg-color) inset}.md-typeset table:not([class]) a{word-break:normal}.md-typeset table th[role=columnheader]{cursor:pointer}[dir=ltr] .md-typeset table th[role=columnheader]:after{margin-left:.5em}[dir=rtl] .md-typeset table th[role=columnheader]:after{margin-right:.5em}.md-typeset table th[role=columnheader]:after{content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-typeset-table-sort-icon);mask-image:var(--md-typeset-table-sort-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset table th[role=columnheader]:hover:after{background-color:var(--md-default-fg-color--lighter)}.md-typeset table th[role=columnheader][aria-sort=ascending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--asc);mask-image:var(--md-typeset-table-sort-icon--asc)}.md-typeset table th[role=columnheader][aria-sort=descending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--desc);mask-image:var(--md-typeset-table-sort-icon--desc)}.md-typeset__scrollwrap{margin:1em -.8rem;overflow-x:auto;touch-action:auto}.md-typeset__table{display:inline-block;margin-bottom:.5em;padding:0 .8rem}@media print{.md-typeset__table{display:block}}html .md-typeset__table table{display:table;margin:0;overflow:hidden;width:100%}@media screen and (max-width:44.984375em){.md-content__inner>pre{margin:1em -.8rem}.md-content__inner>pre code{border-radius:0}}.md-typeset .md-author{border-radius:100%;display:block;flex-shrink:0;height:1.6rem;overflow:hidden;position:relative;transition:color 125ms,transform 125ms;width:1.6rem}.md-typeset .md-author img{display:block}.md-typeset .md-author--more{background:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--lighter);font-size:.6rem;font-weight:700;line-height:1.6rem;text-align:center}.md-typeset .md-author--long{height:2.4rem;width:2.4rem}.md-typeset a.md-author{transform:scale(1)}.md-typeset a.md-author img{filter:grayscale(100%) opacity(75%);transition:filter 125ms}.md-typeset a.md-author:focus,.md-typeset a.md-author:hover{transform:scale(1.1);z-index:1}.md-typeset a.md-author:focus img,.md-typeset a.md-author:hover img{filter:grayscale(0)}.md-banner{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color);overflow:auto}@media print{.md-banner{display:none}}.md-banner--warning{background-color:var(--md-warning-bg-color);color:var(--md-warning-fg-color)}.md-banner__inner{font-size:.7rem;margin:.6rem auto;padding:0 .8rem}[dir=ltr] .md-banner__button{float:right}[dir=rtl] .md-banner__button{float:left}.md-banner__button{color:inherit;cursor:pointer;transition:opacity .25s}.no-js .md-banner__button{display:none}.md-banner__button:hover{opacity:.7}html{font-size:125%;height:100%;overflow-x:hidden}@media screen and (min-width:100em){html{font-size:137.5%}}@media screen and (min-width:125em){html{font-size:150%}}body{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;font-size:.5rem;min-height:100%;position:relative;width:100%}@media print{body{display:block}}@media screen and (max-width:59.984375em){body[data-md-scrolllock]{position:fixed}}.md-grid{margin-left:auto;margin-right:auto;max-width:61rem}.md-container{display:flex;flex-direction:column;flex-grow:1}@media print{.md-container{display:block}}.md-main{flex-grow:1}.md-main__inner{display:flex;height:100%;margin-top:1.5rem}.md-ellipsis{overflow:hidden;text-overflow:ellipsis}.md-toggle{display:none}.md-option{height:0;opacity:0;position:absolute;width:0}.md-option:checked+label:not([hidden]){display:block}.md-option.focus-visible+label{outline-color:var(--md-accent-fg-color);outline-style:auto}.md-skip{background-color:var(--md-default-fg-color);border-radius:.1rem;color:var(--md-default-bg-color);font-size:.64rem;margin:.5rem;opacity:0;outline-color:var(--md-accent-fg-color);padding:.3rem .5rem;position:fixed;transform:translateY(.4rem);z-index:-1}.md-skip:focus{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 175ms 75ms;z-index:10}@page{margin:25mm}:root{--md-clipboard-icon:url('data:image/svg+xml;charset=utf-8,')}.md-clipboard{border-radius:.1rem;color:var(--md-default-fg-color--lightest);cursor:pointer;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;transition:color .25s;width:1.5em;z-index:1}@media print{.md-clipboard{display:none}}.md-clipboard:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}:hover>.md-clipboard{color:var(--md-default-fg-color--light)}.md-clipboard:focus,.md-clipboard:hover{color:var(--md-accent-fg-color)}.md-clipboard:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-image:var(--md-clipboard-icon);mask-image:var(--md-clipboard-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-clipboard--inline{cursor:pointer}.md-clipboard--inline code{transition:color .25s,background-color .25s}.md-clipboard--inline:focus code,.md-clipboard--inline:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}:root{--md-code-select-icon:url('data:image/svg+xml;charset=utf-8,');--md-code-copy-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .md-code__content{display:grid}.md-code__nav{background-color:var(--md-code-bg-color--lighter);border-radius:.1rem;display:flex;gap:.2rem;padding:.2rem;position:absolute;right:.25em;top:.25em;transition:background-color .25s;z-index:1}:hover>.md-code__nav{background-color:var(--md-code-bg-color--light)}.md-code__button{color:var(--md-default-fg-color--lightest);cursor:pointer;display:block;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;transition:color .25s;width:1.5em}:hover>*>.md-code__button{color:var(--md-default-fg-color--light)}.md-code__button.focus-visible,.md-code__button:hover{color:var(--md-accent-fg-color)}.md-code__button--active{color:var(--md-default-fg-color)!important}.md-code__button:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-code__button[data-md-type=select]:after{-webkit-mask-image:var(--md-code-select-icon);mask-image:var(--md-code-select-icon)}.md-code__button[data-md-type=copy]:after{-webkit-mask-image:var(--md-code-copy-icon);mask-image:var(--md-code-copy-icon)}@keyframes consent{0%{opacity:0;transform:translateY(100%)}to{opacity:1;transform:translateY(0)}}@keyframes overlay{0%{opacity:0}to{opacity:1}}.md-consent__overlay{animation:overlay .25s both;-webkit-backdrop-filter:blur(.1rem);backdrop-filter:blur(.1rem);background-color:#0000008a;height:100%;opacity:1;position:fixed;top:0;width:100%;z-index:5}.md-consent__inner{animation:consent .5s cubic-bezier(.1,.7,.1,1) both;background-color:var(--md-default-bg-color);border:0;border-radius:.1rem;bottom:0;box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;max-height:100%;overflow:auto;padding:0;position:fixed;width:100%;z-index:5}.md-consent__form{padding:.8rem}.md-consent__settings{display:none;margin:1em 0}input:checked+.md-consent__settings{display:block}.md-consent__controls{margin-bottom:.8rem}.md-typeset .md-consent__controls .md-button{display:inline}@media screen and (max-width:44.984375em){.md-typeset .md-consent__controls .md-button{display:block;margin-top:.4rem;text-align:center;width:100%}}.md-consent label{cursor:pointer}.md-content{flex-grow:1;min-width:0}.md-content__inner{margin:0 .8rem 1.2rem;padding-top:.6rem}@media screen and (min-width:76.25em){[dir=ltr] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}[dir=ltr] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner,[dir=rtl] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=rtl] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}}.md-content__inner:before{content:"";display:block;height:.4rem}.md-content__inner>:last-child{margin-bottom:0}[dir=ltr] .md-content__button{float:right}[dir=rtl] .md-content__button{float:left}[dir=ltr] .md-content__button{margin-left:.4rem}[dir=rtl] .md-content__button{margin-right:.4rem}.md-content__button{margin:.4rem 0;padding:0}@media print{.md-content__button{display:none}}.md-typeset .md-content__button{color:var(--md-default-fg-color--lighter)}.md-content__button svg{display:inline;vertical-align:top}[dir=rtl] .md-content__button svg{transform:scaleX(-1)}[dir=ltr] .md-dialog{right:.8rem}[dir=rtl] .md-dialog{left:.8rem}.md-dialog{background-color:var(--md-default-fg-color);border-radius:.1rem;bottom:.8rem;box-shadow:var(--md-shadow-z3);min-width:11.1rem;opacity:0;padding:.4rem .6rem;pointer-events:none;position:fixed;transform:translateY(100%);transition:transform 0ms .4s,opacity .4s;z-index:4}@media print{.md-dialog{display:none}}.md-dialog--active{opacity:1;pointer-events:auto;transform:translateY(0);transition:transform .4s cubic-bezier(.075,.85,.175,1),opacity .4s}.md-dialog__inner{color:var(--md-default-bg-color);font-size:.7rem}.md-feedback{margin:2em 0 1em;text-align:center}.md-feedback fieldset{border:none;margin:0;padding:0}.md-feedback__title{font-weight:700;margin:1em auto}.md-feedback__inner{position:relative}.md-feedback__list{display:flex;flex-wrap:wrap;place-content:baseline center;position:relative}.md-feedback__list:hover .md-icon:not(:disabled){color:var(--md-default-fg-color--lighter)}:disabled .md-feedback__list{min-height:1.8rem}.md-feedback__icon{color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;margin:0 .1rem;transition:color 125ms}.md-feedback__icon:not(:disabled).md-icon:hover{color:var(--md-accent-fg-color)}.md-feedback__icon:disabled{color:var(--md-default-fg-color--lightest);pointer-events:none}.md-feedback__note{opacity:0;position:relative;transform:translateY(.4rem);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-feedback__note>*{margin:0 auto;max-width:16rem}:disabled .md-feedback__note{opacity:1;transform:translateY(0)}.md-footer{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color)}@media print{.md-footer{display:none}}.md-footer__inner{justify-content:space-between;overflow:auto;padding:.2rem}.md-footer__inner:not([hidden]){display:flex}.md-footer__link{align-items:end;display:flex;flex-grow:0.01;margin-bottom:.4rem;margin-top:1rem;max-width:100%;outline-color:var(--md-accent-fg-color);overflow:hidden;transition:opacity .25s}.md-footer__link:focus,.md-footer__link:hover{opacity:.7}[dir=rtl] .md-footer__link svg{transform:scaleX(-1)}@media screen and (max-width:44.984375em){.md-footer__link--prev{flex-shrink:0}.md-footer__link--prev .md-footer__title{display:none}}[dir=ltr] .md-footer__link--next{margin-left:auto}[dir=rtl] .md-footer__link--next{margin-right:auto}.md-footer__link--next{text-align:right}[dir=rtl] .md-footer__link--next{text-align:left}.md-footer__title{flex-grow:1;font-size:.9rem;margin-bottom:.7rem;max-width:calc(100% - 2.4rem);padding:0 1rem;white-space:nowrap}.md-footer__button{margin:.2rem;padding:.4rem}.md-footer__direction{font-size:.64rem;opacity:.7}.md-footer-meta{background-color:var(--md-footer-bg-color--dark)}.md-footer-meta__inner{display:flex;flex-wrap:wrap;justify-content:space-between;padding:.2rem}html .md-footer-meta.md-typeset a{color:var(--md-footer-fg-color--light)}html .md-footer-meta.md-typeset a:focus,html .md-footer-meta.md-typeset a:hover{color:var(--md-footer-fg-color)}.md-copyright{color:var(--md-footer-fg-color--lighter);font-size:.64rem;margin:auto .6rem;padding:.4rem 0;width:100%}@media screen and (min-width:45em){.md-copyright{width:auto}}.md-copyright__highlight{color:var(--md-footer-fg-color--light)}.md-social{display:inline-flex;gap:.2rem;margin:0 .4rem;padding:.2rem 0 .6rem}@media screen and (min-width:45em){.md-social{padding:.6rem 0}}.md-social__link{display:inline-block;height:1.6rem;text-align:center;width:1.6rem}.md-social__link:before{line-height:1.9}.md-social__link svg{fill:currentcolor;max-height:.8rem;vertical-align:-25%}.md-typeset .md-button{border:.1rem solid;border-radius:.1rem;color:var(--md-primary-fg-color);cursor:pointer;display:inline-block;font-weight:700;padding:.625em 2em;transition:color 125ms,background-color 125ms,border-color 125ms}.md-typeset .md-button--primary{background-color:var(--md-primary-fg-color);border-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color)}.md-typeset .md-button:focus,.md-typeset .md-button:hover{background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[dir=ltr] .md-typeset .md-input{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .md-input,[dir=rtl] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-left-radius:.1rem}.md-typeset .md-input{border-bottom:.1rem solid var(--md-default-fg-color--lighter);box-shadow:var(--md-shadow-z1);font-size:.8rem;height:1.8rem;padding:0 .6rem;transition:border .25s,box-shadow .25s}.md-typeset .md-input:focus,.md-typeset .md-input:hover{border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input--stretch{width:100%}.md-header{background-color:var(--md-primary-fg-color);box-shadow:0 0 .2rem #0000,0 .2rem .4rem #0000;color:var(--md-primary-bg-color);display:block;left:0;position:sticky;right:0;top:0;z-index:4}@media print{.md-header{display:none}}.md-header[hidden]{transform:translateY(-100%);transition:transform .25s cubic-bezier(.8,0,.6,1),box-shadow .25s}.md-header--shadow{box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;transition:transform .25s cubic-bezier(.1,.7,.1,1),box-shadow .25s}.md-header__inner{align-items:center;display:flex;padding:0 .2rem}.md-header__button{color:currentcolor;cursor:pointer;margin:.2rem;outline-color:var(--md-accent-fg-color);padding:.4rem;position:relative;transition:opacity .25s;vertical-align:middle;z-index:1}.md-header__button:hover{opacity:.7}.md-header__button:not([hidden]){display:inline-block}.md-header__button:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-header__button.md-logo{margin:.2rem;padding:.4rem}@media screen and (max-width:76.234375em){.md-header__button.md-logo{display:none}}.md-header__button.md-logo img,.md-header__button.md-logo svg{fill:currentcolor;display:block;height:1.2rem;width:auto}@media screen and (min-width:60em){.md-header__button[for=__search]{display:none}}.no-js .md-header__button[for=__search]{display:none}[dir=rtl] .md-header__button[for=__search] svg{transform:scaleX(-1)}@media screen and (min-width:76.25em){.md-header__button[for=__drawer]{display:none}}.md-header__topic{display:flex;max-width:100%;position:absolute;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;white-space:nowrap}.md-header__topic+.md-header__topic{opacity:0;pointer-events:none;transform:translateX(1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__topic+.md-header__topic{transform:translateX(-1.25rem)}.md-header__topic:first-child{font-weight:700}[dir=ltr] .md-header__title{margin-left:1rem;margin-right:.4rem}[dir=rtl] .md-header__title{margin-left:.4rem;margin-right:1rem}.md-header__title{flex-grow:1;font-size:.9rem;height:2.4rem;line-height:2.4rem}.md-header__title--active .md-header__topic{opacity:0;pointer-events:none;transform:translateX(-1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__title--active .md-header__topic{transform:translateX(1.25rem)}.md-header__title--active .md-header__topic+.md-header__topic{opacity:1;pointer-events:auto;transform:translateX(0);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;z-index:0}.md-header__title>.md-header__ellipsis{height:100%;position:relative;width:100%}.md-header__option{display:flex;flex-shrink:0;max-width:100%;transition:max-width 0ms .25s,opacity .25s .25s;white-space:nowrap}[data-md-toggle=search]:checked~.md-header .md-header__option{max-width:0;opacity:0;transition:max-width 0ms,opacity 0ms}.md-header__option>input{bottom:0}.md-header__source{display:none}@media screen and (min-width:60em){[dir=ltr] .md-header__source{margin-left:1rem}[dir=rtl] .md-header__source{margin-right:1rem}.md-header__source{display:block;max-width:11.7rem;width:11.7rem}}@media screen and (min-width:76.25em){[dir=ltr] .md-header__source{margin-left:1.4rem}[dir=rtl] .md-header__source{margin-right:1.4rem}}.md-meta{color:var(--md-default-fg-color--light);font-size:.7rem;line-height:1.3}.md-meta__list{display:inline-flex;flex-wrap:wrap;list-style:none;margin:0;padding:0}.md-meta__item:not(:last-child):after{content:"·";margin-left:.2rem;margin-right:.2rem}.md-meta__link{color:var(--md-typeset-a-color)}.md-meta__link:focus,.md-meta__link:hover{color:var(--md-accent-fg-color)}.md-draft{background-color:#ff1744;border-radius:.125em;color:#fff;display:inline-block;font-weight:700;padding-left:.5714285714em;padding-right:.5714285714em}:root{--md-nav-icon--prev:url('data:image/svg+xml;charset=utf-8,');--md-nav-icon--next:url('data:image/svg+xml;charset=utf-8,');--md-toc-icon:url('data:image/svg+xml;charset=utf-8,')}.md-nav{font-size:.7rem;line-height:1.3}.md-nav__title{color:var(--md-default-fg-color--light);display:block;font-weight:700;overflow:hidden;padding:0 .6rem;text-overflow:ellipsis}.md-nav__title .md-nav__button{display:none}.md-nav__title .md-nav__button img{height:100%;width:auto}.md-nav__title .md-nav__button.md-logo img,.md-nav__title .md-nav__button.md-logo svg{fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__list{list-style:none;margin:0;padding:0}.md-nav__link{align-items:flex-start;display:flex;gap:.4rem;margin-top:.625em;scroll-snap-align:start;transition:color 125ms}.md-nav__link--passed,.md-nav__link--passed code{color:var(--md-default-fg-color--light)}.md-nav__item .md-nav__link--active,.md-nav__item .md-nav__link--active code{color:var(--md-typeset-a-color)}.md-nav__link .md-ellipsis{position:relative}.md-nav__link .md-ellipsis code{word-break:normal}[dir=ltr] .md-nav__link .md-icon:last-child{margin-left:auto}[dir=rtl] .md-nav__link .md-icon:last-child{margin-right:auto}.md-nav__link .md-typeset{font-size:.7rem;line-height:1.3}.md-nav__link svg{fill:currentcolor;flex-shrink:0;height:1.3em}.md-nav__link[for]:focus,.md-nav__link[for]:hover,.md-nav__link[href]:focus,.md-nav__link[href]:hover{color:var(--md-accent-fg-color);cursor:pointer}.md-nav__link[for]:focus code,.md-nav__link[for]:hover code,.md-nav__link[href]:focus code,.md-nav__link[href]:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-nav__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-nav--primary .md-nav__link[for=__toc]{display:none}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{background-color:currentcolor;display:block;height:100%;-webkit-mask-image:var(--md-toc-icon);mask-image:var(--md-toc-icon);width:100%}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:none}.md-nav__container>.md-nav__link{margin-top:0}.md-nav__container>.md-nav__link:first-child{flex-grow:1;min-width:0}.md-nav__icon{flex-shrink:0}.md-nav__source{display:none}@media screen and (max-width:76.234375em){.md-nav--primary,.md-nav--primary .md-nav{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;height:100%;left:0;position:absolute;right:0;top:0;z-index:1}.md-nav--primary .md-nav__item,.md-nav--primary .md-nav__title{font-size:.8rem;line-height:1.5}.md-nav--primary .md-nav__title{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);cursor:pointer;height:5.6rem;line-height:2.4rem;padding:3rem .8rem .2rem;position:relative;white-space:nowrap}[dir=ltr] .md-nav--primary .md-nav__title .md-nav__icon{left:.4rem}[dir=rtl] .md-nav--primary .md-nav__title .md-nav__icon{right:.4rem}.md-nav--primary .md-nav__title .md-nav__icon{display:block;height:1.2rem;margin:.2rem;position:absolute;top:.4rem;width:1.2rem}.md-nav--primary .md-nav__title .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--prev);mask-image:var(--md-nav-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}.md-nav--primary .md-nav__title~.md-nav__list{background-color:var(--md-default-bg-color);box-shadow:0 .05rem 0 var(--md-default-fg-color--lightest) inset;overflow-y:auto;scroll-snap-type:y mandatory;touch-action:pan-y}.md-nav--primary .md-nav__title~.md-nav__list>:first-child{border-top:0}.md-nav--primary .md-nav__title[for=__drawer]{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);font-weight:700}.md-nav--primary .md-nav__title .md-logo{display:block;left:.2rem;margin:.2rem;padding:.4rem;position:absolute;right:.2rem;top:.2rem}.md-nav--primary .md-nav__list{flex:1}.md-nav--primary .md-nav__item{border-top:.05rem solid var(--md-default-fg-color--lightest)}.md-nav--primary .md-nav__item--active>.md-nav__link{color:var(--md-typeset-a-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:focus,.md-nav--primary .md-nav__item--active>.md-nav__link:hover{color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__link{margin-top:0;padding:.6rem .8rem}.md-nav--primary .md-nav__link svg{margin-top:.1em}.md-nav--primary .md-nav__link>.md-nav__link{padding:0}[dir=ltr] .md-nav--primary .md-nav__link .md-nav__icon{margin-right:-.2rem}[dir=rtl] .md-nav--primary .md-nav__link .md-nav__icon{margin-left:-.2rem}.md-nav--primary .md-nav__link .md-nav__icon{font-size:1.2rem;height:1.2rem;width:1.2rem}.md-nav--primary .md-nav__link .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-nav--primary .md-nav__icon:after{transform:scale(-1)}.md-nav--primary .md-nav--secondary .md-nav{background-color:initial;position:static}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-left:1.4rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-right:1.4rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-left:2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-right:2rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-left:2.6rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-right:2.6rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-left:3.2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-right:3.2rem}.md-nav--secondary{background-color:initial}.md-nav__toggle~.md-nav{display:flex;opacity:0;transform:translateX(100%);transition:transform .25s cubic-bezier(.8,0,.6,1),opacity 125ms 50ms}[dir=rtl] .md-nav__toggle~.md-nav{transform:translateX(-100%)}.md-nav__toggle:checked~.md-nav{opacity:1;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 125ms 125ms}.md-nav__toggle:checked~.md-nav>.md-nav__list{-webkit-backface-visibility:hidden;backface-visibility:hidden}}@media screen and (max-width:59.984375em){.md-nav--primary .md-nav__link[for=__toc]{display:flex}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--primary .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:flex}.md-nav__source{background-color:var(--md-primary-fg-color--dark);color:var(--md-primary-bg-color);display:block;padding:0 .2rem}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-nav--integrated .md-nav__link[for=__toc]{display:flex}.md-nav--integrated .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--integrated .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--integrated .md-nav__link[for=__toc]~.md-nav{display:flex}}@media screen and (min-width:60em){.md-nav{margin-bottom:-.4rem}.md-nav--secondary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--secondary .md-nav__title[for=__toc]{scroll-snap-align:start}.md-nav--secondary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--secondary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--secondary .md-nav__list{padding-right:.6rem}.md-nav--secondary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--secondary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--secondary .md-nav__item>.md-nav__link{margin-left:.4rem}}@media screen and (min-width:76.25em){.md-nav{margin-bottom:-.4rem;transition:max-height .25s cubic-bezier(.86,0,.07,1)}.md-nav--primary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--primary .md-nav__title[for=__drawer]{scroll-snap-align:start}.md-nav--primary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--primary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--primary .md-nav__list{padding-right:.6rem}.md-nav--primary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--primary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--primary .md-nav__item>.md-nav__link{margin-left:.4rem}.md-nav__toggle~.md-nav{display:grid;grid-template-rows:0fr;opacity:0;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .25s,visibility 0ms .25s;visibility:collapse}.md-nav__toggle~.md-nav>.md-nav__list{overflow:hidden}.md-nav__toggle:checked~.md-nav,.md-nav__toggle:indeterminate~.md-nav{grid-template-rows:1fr;opacity:1;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .15s .1s,visibility 0ms;visibility:visible}.md-nav__item--nested>.md-nav>.md-nav__title{display:none}.md-nav__item--section{display:block;margin:1.25em 0}.md-nav__item--section:last-child{margin-bottom:0}.md-nav__item--section>.md-nav__link{font-weight:700}.md-nav__item--section>.md-nav__link[for]{color:var(--md-default-fg-color--light)}.md-nav__item--section>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav__item--section>.md-nav__link .md-icon,.md-nav__item--section>.md-nav__link>[for]{display:none}[dir=ltr] .md-nav__item--section>.md-nav{margin-left:-.6rem}[dir=rtl] .md-nav__item--section>.md-nav{margin-right:-.6rem}.md-nav__item--section>.md-nav{display:block;opacity:1;visibility:visible}.md-nav__item--section>.md-nav>.md-nav__list>.md-nav__item{padding:0}.md-nav__icon{border-radius:100%;height:.9rem;transition:background-color .25s;width:.9rem}.md-nav__icon:hover{background-color:var(--md-accent-fg-color--transparent)}.md-nav__icon:after{background-color:currentcolor;border-radius:100%;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:transform .25s;vertical-align:-.1rem;width:100%}[dir=rtl] .md-nav__icon:after{transform:rotate(180deg)}.md-nav__item--nested .md-nav__toggle:checked~.md-nav__link .md-nav__icon:after,.md-nav__item--nested .md-nav__toggle:indeterminate~.md-nav__link .md-nav__icon:after{transform:rotate(90deg)}.md-nav--lifted>.md-nav__list>.md-nav__item,.md-nav--lifted>.md-nav__title{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active{display:block}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);margin-top:0;position:sticky;top:0;z-index:1}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active.md-nav__item--section{margin:0}[dir=ltr] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav{margin-left:-.6rem}[dir=rtl] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav{margin-right:-.6rem}.md-nav--lifted>.md-nav__list>.md-nav__item>[for]{color:var(--md-default-fg-color--light)}.md-nav--lifted .md-nav[data-md-level="1"]{grid-template-rows:1fr;opacity:1;visibility:visible}.md-nav--integrated>.md-nav__list>.md-nav__item--active:not(.md-nav__item--nested){padding:0 .6rem}.md-nav--integrated>.md-nav__list>.md-nav__item--active:not(.md-nav__item--nested)>.md-nav__link{padding:0}[dir=ltr] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-left:.05rem solid var(--md-primary-fg-color)}[dir=rtl] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-right:.05rem solid var(--md-primary-fg-color)}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{display:block;margin-bottom:1.25em;opacity:1;visibility:visible}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__list{overflow:visible;padding-bottom:0}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__title{display:none}}.md-pagination{font-size:.8rem;font-weight:700;gap:.4rem}.md-pagination,.md-pagination>*{align-items:center;display:flex;justify-content:center}.md-pagination>*{border-radius:.2rem;height:1.8rem;min-width:1.8rem;text-align:center}.md-pagination__current{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light)}.md-pagination__link{transition:color 125ms,background-color 125ms}.md-pagination__link:focus,.md-pagination__link:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-pagination__link:focus svg,.md-pagination__link:hover svg{color:var(--md-accent-fg-color)}.md-pagination__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-pagination__link svg{fill:currentcolor;color:var(--md-default-fg-color--lighter);display:block;max-height:100%;width:1.2rem}:root{--md-path-icon:url('data:image/svg+xml;charset=utf-8,')}.md-path{display:block;font-size:.7rem;margin:0 .8rem;overflow:auto;padding-top:1.2rem}@media screen and (min-width:76.25em){.md-path{margin:0 1.2rem}}.md-path__list{align-items:center;display:flex;gap:.2rem;list-style:none;margin:0;padding:0}.md-path__item:not(:first-child){display:inline-flex;gap:.2rem;white-space:nowrap}.md-path__item:not(:first-child):before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline;height:.8rem;-webkit-mask-image:var(--md-path-icon);mask-image:var(--md-path-icon);width:.8rem}.md-path__link{align-items:center;color:var(--md-default-fg-color--light);display:flex}.md-path__link:focus,.md-path__link:hover{color:var(--md-accent-fg-color)}.md-post__back{border-bottom:.05rem solid var(--md-default-fg-color--lightest);margin-bottom:1.2rem;padding-bottom:1.2rem}@media screen and (max-width:76.234375em){.md-post__back{display:none}}[dir=rtl] .md-post__back svg{transform:scaleX(-1)}.md-post__authors{display:flex;flex-direction:column;gap:.6rem;margin:0 .6rem 1.2rem}.md-post .md-post__meta a{transition:color 125ms}.md-post .md-post__meta a:focus,.md-post .md-post__meta a:hover{color:var(--md-accent-fg-color)}.md-post__title{color:var(--md-default-fg-color--light);font-weight:700}.md-post--excerpt{margin-bottom:3.2rem}.md-post--excerpt .md-post__header{align-items:center;display:flex;gap:.6rem;min-height:1.6rem}.md-post--excerpt .md-post__authors{align-items:center;display:inline-flex;flex-direction:row;gap:.2rem;margin:0;min-height:2.4rem}[dir=ltr] .md-post--excerpt .md-post__meta .md-meta__list{margin-right:.4rem}[dir=rtl] .md-post--excerpt .md-post__meta .md-meta__list{margin-left:.4rem}.md-post--excerpt .md-post__content>:first-child{--md-scroll-margin:6rem;margin-top:0}.md-post>.md-nav--secondary{margin:1em 0}.md-profile{align-items:center;display:flex;font-size:.7rem;gap:.6rem;line-height:1.4;width:100%}.md-profile__description{flex-grow:1}.md-content--post{display:flex}@media screen and (max-width:76.234375em){.md-content--post{flex-flow:column-reverse}}.md-content--post>.md-content__inner{min-width:0}@media screen and (min-width:76.25em){[dir=ltr] .md-content--post>.md-content__inner{margin-left:1.2rem}[dir=rtl] .md-content--post>.md-content__inner{margin-right:1.2rem}}@media screen and (max-width:76.234375em){.md-sidebar.md-sidebar--post{padding:0;position:static;width:100%}.md-sidebar.md-sidebar--post .md-sidebar__scrollwrap{overflow:visible}.md-sidebar.md-sidebar--post .md-sidebar__inner{padding:0}.md-sidebar.md-sidebar--post .md-post__meta{margin-left:.6rem;margin-right:.6rem}.md-sidebar.md-sidebar--post .md-nav__item{border:none;display:inline}.md-sidebar.md-sidebar--post .md-nav__list{display:inline-flex;flex-wrap:wrap;gap:.6rem;padding-bottom:.6rem;padding-top:.6rem}.md-sidebar.md-sidebar--post .md-nav__link{padding:0}.md-sidebar.md-sidebar--post .md-nav{height:auto;margin-bottom:0;position:static}}:root{--md-progress-value:0;--md-progress-delay:400ms}.md-progress{background:var(--md-primary-bg-color);height:.075rem;opacity:min(clamp(0,var(--md-progress-value),1),clamp(0,100 - var(--md-progress-value),1));position:fixed;top:0;transform:scaleX(calc(var(--md-progress-value)*1%));transform-origin:left;transition:transform .5s cubic-bezier(.19,1,.22,1),opacity .25s var(--md-progress-delay);width:100%;z-index:4}:root{--md-search-result-icon:url('data:image/svg+xml;charset=utf-8,')}.md-search{position:relative}@media screen and (min-width:60em){.md-search{padding:.2rem 0}}.no-js .md-search{display:none}.md-search__overlay{opacity:0;z-index:1}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__overlay{left:-2.2rem}[dir=rtl] .md-search__overlay{right:-2.2rem}.md-search__overlay{background-color:var(--md-default-bg-color);border-radius:1rem;height:2rem;overflow:hidden;pointer-events:none;position:absolute;top:-1rem;transform-origin:center;transition:transform .3s .1s,opacity .2s .2s;width:2rem}[data-md-toggle=search]:checked~.md-header .md-search__overlay{opacity:1;transition:transform .4s,opacity .1s}}@media screen and (min-width:60em){[dir=ltr] .md-search__overlay{left:0}[dir=rtl] .md-search__overlay{right:0}.md-search__overlay{background-color:#0000008a;cursor:pointer;height:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0}[data-md-toggle=search]:checked~.md-header .md-search__overlay{height:200vh;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@media screen and (max-width:29.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(45)}}@media screen and (min-width:30em) and (max-width:44.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(60)}}@media screen and (min-width:45em) and (max-width:59.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(75)}}.md-search__inner{-webkit-backface-visibility:hidden;backface-visibility:hidden}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__inner{left:0}[dir=rtl] .md-search__inner{right:0}.md-search__inner{height:0;opacity:0;overflow:hidden;position:fixed;top:0;transform:translateX(5%);transition:width 0ms .3s,height 0ms .3s,transform .15s cubic-bezier(.4,0,.2,1) .15s,opacity .15s .15s;width:0;z-index:2}[dir=rtl] .md-search__inner{transform:translateX(-5%)}[data-md-toggle=search]:checked~.md-header .md-search__inner{height:100%;opacity:1;transform:translateX(0);transition:width 0ms 0ms,height 0ms 0ms,transform .15s cubic-bezier(.1,.7,.1,1) .15s,opacity .15s .15s;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__inner{float:right}[dir=rtl] .md-search__inner{float:left}.md-search__inner{padding:.1rem 0;position:relative;transition:width .25s cubic-bezier(.1,.7,.1,1);width:11.7rem}}@media screen and (min-width:60em) and (max-width:76.234375em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:23.4rem}}@media screen and (min-width:76.25em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:34.4rem}}.md-search__form{background-color:var(--md-default-bg-color);box-shadow:0 0 .6rem #0000;height:2.4rem;position:relative;transition:color .25s,background-color .25s;z-index:2}@media screen and (min-width:60em){.md-search__form{background-color:#00000042;border-radius:.1rem;height:1.8rem}.md-search__form:hover{background-color:#ffffff1f}}[data-md-toggle=search]:checked~.md-header .md-search__form{background-color:var(--md-default-bg-color);border-radius:.1rem .1rem 0 0;box-shadow:0 0 .6rem #00000012;color:var(--md-default-fg-color)}[dir=ltr] .md-search__input{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__input{padding-left:2.2rem;padding-right:3.6rem}.md-search__input{background:#0000;font-size:.9rem;height:100%;position:relative;text-overflow:ellipsis;width:100%;z-index:2}.md-search__input::placeholder{transition:color .25s}.md-search__input::placeholder,.md-search__input~.md-search__icon{color:var(--md-default-fg-color--light)}.md-search__input::-ms-clear{display:none}@media screen and (max-width:59.984375em){.md-search__input{font-size:.9rem;height:2.4rem;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__input{padding-left:2.2rem}[dir=rtl] .md-search__input{padding-right:2.2rem}.md-search__input{color:inherit;font-size:.8rem}.md-search__input::placeholder{color:var(--md-primary-bg-color--light)}.md-search__input+.md-search__icon{color:var(--md-primary-bg-color)}[data-md-toggle=search]:checked~.md-header .md-search__input{text-overflow:clip}[data-md-toggle=search]:checked~.md-header .md-search__input+.md-search__icon{color:var(--md-default-fg-color--light)}[data-md-toggle=search]:checked~.md-header .md-search__input::placeholder{color:#0000}}.md-search__icon{cursor:pointer;display:inline-block;height:1.2rem;transition:color .25s,opacity .25s;width:1.2rem}.md-search__icon:hover{opacity:.7}[dir=ltr] .md-search__icon[for=__search]{left:.5rem}[dir=rtl] .md-search__icon[for=__search]{right:.5rem}.md-search__icon[for=__search]{position:absolute;top:.3rem;z-index:2}[dir=rtl] .md-search__icon[for=__search] svg{transform:scaleX(-1)}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__icon[for=__search]{left:.8rem}[dir=rtl] .md-search__icon[for=__search]{right:.8rem}.md-search__icon[for=__search]{top:.6rem}.md-search__icon[for=__search] svg:first-child{display:none}}@media screen and (min-width:60em){.md-search__icon[for=__search]{pointer-events:none}.md-search__icon[for=__search] svg:last-child{display:none}}[dir=ltr] .md-search__options{right:.5rem}[dir=rtl] .md-search__options{left:.5rem}.md-search__options{pointer-events:none;position:absolute;top:.3rem;z-index:2}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__options{right:.8rem}[dir=rtl] .md-search__options{left:.8rem}.md-search__options{top:.6rem}}[dir=ltr] .md-search__options>.md-icon{margin-left:.2rem}[dir=rtl] .md-search__options>.md-icon{margin-right:.2rem}.md-search__options>.md-icon{color:var(--md-default-fg-color--light);opacity:0;transform:scale(.75);transition:transform .15s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-search__options>.md-icon:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon{opacity:1;pointer-events:auto;transform:scale(1)}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon:hover{opacity:.7}[dir=ltr] .md-search__suggest{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__suggest{padding-left:2.2rem;padding-right:3.6rem}.md-search__suggest{align-items:center;color:var(--md-default-fg-color--lighter);display:flex;font-size:.9rem;height:100%;opacity:0;position:absolute;top:0;transition:opacity 50ms;white-space:nowrap;width:100%}@media screen and (min-width:60em){[dir=ltr] .md-search__suggest{padding-left:2.2rem}[dir=rtl] .md-search__suggest{padding-right:2.2rem}.md-search__suggest{font-size:.8rem}}[data-md-toggle=search]:checked~.md-header .md-search__suggest{opacity:1;transition:opacity .3s .1s}[dir=ltr] .md-search__output{border-bottom-left-radius:.1rem}[dir=ltr] .md-search__output,[dir=rtl] .md-search__output{border-bottom-right-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-left-radius:.1rem}.md-search__output{overflow:hidden;position:absolute;width:100%;z-index:1}@media screen and (max-width:59.984375em){.md-search__output{bottom:0;top:2.4rem}}@media screen and (min-width:60em){.md-search__output{opacity:0;top:1.9rem;transition:opacity .4s}[data-md-toggle=search]:checked~.md-header .md-search__output{box-shadow:var(--md-shadow-z3);opacity:1}}.md-search__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);height:100%;overflow-y:auto;touch-action:pan-y}@media (-webkit-max-device-pixel-ratio:1),(max-resolution:1dppx){.md-search__scrollwrap{transform:translateZ(0)}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-search__scrollwrap{width:23.4rem}}@media screen and (min-width:76.25em){.md-search__scrollwrap{width:34.4rem}}@media screen and (min-width:60em){.md-search__scrollwrap{max-height:0;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}[data-md-toggle=search]:checked~.md-header .md-search__scrollwrap{max-height:75vh}.md-search__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-search__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-search__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-search__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}}.md-search-result{color:var(--md-default-fg-color);word-break:break-word}.md-search-result__meta{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.8rem;padding:0 .8rem;scroll-snap-align:start}@media screen and (min-width:60em){[dir=ltr] .md-search-result__meta{padding-left:2.2rem}[dir=rtl] .md-search-result__meta{padding-right:2.2rem}}.md-search-result__list{list-style:none;margin:0;padding:0;-webkit-user-select:none;user-select:none}.md-search-result__item{box-shadow:0 -.05rem var(--md-default-fg-color--lightest)}.md-search-result__item:first-child{box-shadow:none}.md-search-result__link{display:block;outline:none;scroll-snap-align:start;transition:background-color .25s}.md-search-result__link:focus,.md-search-result__link:hover{background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:last-child p:last-child{margin-bottom:.6rem}.md-search-result__more>summary{cursor:pointer;display:block;outline:none;position:sticky;scroll-snap-align:start;top:0;z-index:1}.md-search-result__more>summary::marker{display:none}.md-search-result__more>summary::-webkit-details-marker{display:none}.md-search-result__more>summary>div{color:var(--md-typeset-a-color);font-size:.64rem;padding:.75em .8rem;transition:color .25s,background-color .25s}@media screen and (min-width:60em){[dir=ltr] .md-search-result__more>summary>div{padding-left:2.2rem}[dir=rtl] .md-search-result__more>summary>div{padding-right:2.2rem}}.md-search-result__more>summary:focus>div,.md-search-result__more>summary:hover>div{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more[open]>summary{background-color:var(--md-default-bg-color)}.md-search-result__article{overflow:hidden;padding:0 .8rem;position:relative}@media screen and (min-width:60em){[dir=ltr] .md-search-result__article{padding-left:2.2rem}[dir=rtl] .md-search-result__article{padding-right:2.2rem}}[dir=ltr] .md-search-result__icon{left:0}[dir=rtl] .md-search-result__icon{right:0}.md-search-result__icon{color:var(--md-default-fg-color--light);height:1.2rem;margin:.5rem;position:absolute;width:1.2rem}@media screen and (max-width:59.984375em){.md-search-result__icon{display:none}}.md-search-result__icon:after{background-color:currentcolor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-search-result-icon);mask-image:var(--md-search-result-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-search-result__icon:after{transform:scaleX(-1)}.md-search-result .md-typeset{color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.6}.md-search-result .md-typeset h1{color:var(--md-default-fg-color);font-size:.8rem;font-weight:400;line-height:1.4;margin:.55rem 0}.md-search-result .md-typeset h1 mark{text-decoration:none}.md-search-result .md-typeset h2{color:var(--md-default-fg-color);font-size:.64rem;font-weight:700;line-height:1.6;margin:.5em 0}.md-search-result .md-typeset h2 mark{text-decoration:none}.md-search-result__terms{color:var(--md-default-fg-color);display:block;font-size:.64rem;font-style:italic;margin:.5em 0}.md-search-result mark{background-color:initial;color:var(--md-accent-fg-color);text-decoration:underline}.md-select{position:relative;z-index:1}.md-select__inner{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:50%;margin-top:.2rem;max-height:0;opacity:0;position:absolute;top:calc(100% - .2rem);transform:translate3d(-50%,.3rem,0);transition:transform .25s 375ms,opacity .25s .25s,max-height 0ms .5s}.md-select:focus-within .md-select__inner,.md-select:hover .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select__inner:after{border-bottom:.2rem solid #0000;border-bottom-color:var(--md-default-bg-color);border-left:.2rem solid #0000;border-right:.2rem solid #0000;border-top:0;content:"";height:0;left:50%;margin-left:-.2rem;margin-top:-.2rem;position:absolute;top:0;width:0}.md-select__list{border-radius:.1rem;font-size:.8rem;list-style-type:none;margin:0;max-height:inherit;overflow:auto;padding:0}.md-select__item{line-height:1.8rem}[dir=ltr] .md-select__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-select__link{padding-left:1.2rem;padding-right:.6rem}.md-select__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:background-color .25s,color .25s;width:100%}.md-select__link:focus,.md-select__link:hover{color:var(--md-accent-fg-color)}.md-select__link:focus{background-color:var(--md-default-fg-color--lightest)}.md-sidebar{align-self:flex-start;flex-shrink:0;padding:1.2rem 0;position:sticky;top:2.4rem;width:12.1rem}@media print{.md-sidebar{display:none}}@media screen and (max-width:76.234375em){[dir=ltr] .md-sidebar--primary{left:-12.1rem}[dir=rtl] .md-sidebar--primary{right:-12.1rem}.md-sidebar--primary{background-color:var(--md-default-bg-color);display:block;height:100%;position:fixed;top:0;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),box-shadow .25s;width:12.1rem;z-index:5}[data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{box-shadow:var(--md-shadow-z3);transform:translateX(12.1rem)}[dir=rtl] [data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{transform:translateX(-12.1rem)}.md-sidebar--primary .md-sidebar__scrollwrap{bottom:0;left:0;margin:0;overflow:hidden;position:absolute;right:0;scroll-snap-type:none;top:0}}@media screen and (min-width:76.25em){.md-sidebar{height:0}.no-js .md-sidebar{height:auto}.md-header--lifted~.md-container .md-sidebar{top:4.8rem}}.md-sidebar--secondary{display:none;order:2}@media screen and (min-width:60em){.md-sidebar--secondary{height:0}.no-js .md-sidebar--secondary{height:auto}.md-sidebar--secondary:not([hidden]){display:block}.md-sidebar--secondary .md-sidebar__scrollwrap{touch-action:pan-y}}.md-sidebar__scrollwrap{scrollbar-gutter:stable;-webkit-backface-visibility:hidden;backface-visibility:hidden;margin:0 .2rem;overflow-y:auto;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}.md-sidebar__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-sidebar__scrollwrap:focus-within,.md-sidebar__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb:hover,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}@supports selector(::-webkit-scrollbar){.md-sidebar__scrollwrap{scrollbar-gutter:auto}[dir=ltr] .md-sidebar__inner{padding-right:calc(100% - 11.5rem)}[dir=rtl] .md-sidebar__inner{padding-left:calc(100% - 11.5rem)}}@media screen and (max-width:76.234375em){.md-overlay{background-color:#0000008a;height:0;opacity:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0;z-index:5}[data-md-toggle=drawer]:checked~.md-overlay{height:100%;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@keyframes facts{0%{height:0}to{height:.65rem}}@keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}:root{--md-source-forks-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-repositories-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-stars-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-version-icon:url('data:image/svg+xml;charset=utf-8,')}.md-source{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.65rem;line-height:1.2;outline-color:var(--md-accent-fg-color);transition:opacity .25s;white-space:nowrap}.md-source:hover{opacity:.7}.md-source__icon{display:inline-block;height:2.4rem;vertical-align:middle;width:2rem}[dir=ltr] .md-source__icon svg{margin-left:.6rem}[dir=rtl] .md-source__icon svg{margin-right:.6rem}.md-source__icon svg{margin-top:.6rem}[dir=ltr] .md-source__icon+.md-source__repository{padding-left:2rem}[dir=rtl] .md-source__icon+.md-source__repository{padding-right:2rem}[dir=ltr] .md-source__icon+.md-source__repository{margin-left:-2rem}[dir=rtl] .md-source__icon+.md-source__repository{margin-right:-2rem}[dir=ltr] .md-source__repository{margin-left:.6rem}[dir=rtl] .md-source__repository{margin-right:.6rem}.md-source__repository{display:inline-block;max-width:calc(100% - 1.2rem);overflow:hidden;text-overflow:ellipsis;vertical-align:middle}.md-source__facts{display:flex;font-size:.55rem;gap:.4rem;list-style-type:none;margin:.1rem 0 0;opacity:.75;overflow:hidden;padding:0;width:100%}.md-source__repository--active .md-source__facts{animation:facts .25s ease-in}.md-source__fact{overflow:hidden;text-overflow:ellipsis}.md-source__repository--active .md-source__fact{animation:fact .4s ease-out}[dir=ltr] .md-source__fact:before{margin-right:.1rem}[dir=rtl] .md-source__fact:before{margin-left:.1rem}.md-source__fact:before{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-top;width:.6rem}.md-source__fact:nth-child(1n+2){flex-shrink:0}.md-source__fact--version:before{-webkit-mask-image:var(--md-source-version-icon);mask-image:var(--md-source-version-icon)}.md-source__fact--stars:before{-webkit-mask-image:var(--md-source-stars-icon);mask-image:var(--md-source-stars-icon)}.md-source__fact--forks:before{-webkit-mask-image:var(--md-source-forks-icon);mask-image:var(--md-source-forks-icon)}.md-source__fact--repositories:before{-webkit-mask-image:var(--md-source-repositories-icon);mask-image:var(--md-source-repositories-icon)}.md-source-file{margin:1em 0}[dir=ltr] .md-source-file__fact{margin-right:.6rem}[dir=rtl] .md-source-file__fact{margin-left:.6rem}.md-source-file__fact{align-items:center;color:var(--md-default-fg-color--light);display:inline-flex;font-size:.68rem;gap:.3rem}.md-source-file__fact .md-icon{flex-shrink:0;margin-bottom:.05rem}[dir=ltr] .md-source-file__fact .md-author{float:left}[dir=rtl] .md-source-file__fact .md-author{float:right}.md-source-file__fact .md-author{margin-right:.2rem}.md-source-file__fact svg{width:.9rem}:root{--md-status:url('data:image/svg+xml;charset=utf-8,');--md-status--new:url('data:image/svg+xml;charset=utf-8,');--md-status--deprecated:url('data:image/svg+xml;charset=utf-8,');--md-status--encrypted:url('data:image/svg+xml;charset=utf-8,')}.md-status:after{background-color:var(--md-default-fg-color--light);content:"";display:inline-block;height:1.125em;-webkit-mask-image:var(--md-status);mask-image:var(--md-status);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-bottom;width:1.125em}.md-status:hover:after{background-color:currentcolor}.md-status--new:after{-webkit-mask-image:var(--md-status--new);mask-image:var(--md-status--new)}.md-status--deprecated:after{-webkit-mask-image:var(--md-status--deprecated);mask-image:var(--md-status--deprecated)}.md-status--encrypted:after{-webkit-mask-image:var(--md-status--encrypted);mask-image:var(--md-status--encrypted)}.md-tabs{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);display:block;line-height:1.3;overflow:auto;width:100%;z-index:3}@media print{.md-tabs{display:none}}@media screen and (max-width:76.234375em){.md-tabs{display:none}}.md-tabs[hidden]{pointer-events:none}[dir=ltr] .md-tabs__list{margin-left:.2rem}[dir=rtl] .md-tabs__list{margin-right:.2rem}.md-tabs__list{contain:content;display:flex;list-style:none;margin:0;overflow:auto;padding:0;scrollbar-width:none;white-space:nowrap}.md-tabs__list::-webkit-scrollbar{display:none}.md-tabs__item{height:2.4rem;padding-left:.6rem;padding-right:.6rem}.md-tabs__item--active .md-tabs__link{color:inherit;opacity:1}.md-tabs__link{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:flex;font-size:.7rem;margin-top:.8rem;opacity:.7;outline-color:var(--md-accent-fg-color);outline-offset:.2rem;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .25s}.md-tabs__link:focus,.md-tabs__link:hover{color:inherit;opacity:1}[dir=ltr] .md-tabs__link svg{margin-right:.4rem}[dir=rtl] .md-tabs__link svg{margin-left:.4rem}.md-tabs__link svg{fill:currentcolor;height:1.3em}.md-tabs__item:nth-child(2) .md-tabs__link{transition-delay:20ms}.md-tabs__item:nth-child(3) .md-tabs__link{transition-delay:40ms}.md-tabs__item:nth-child(4) .md-tabs__link{transition-delay:60ms}.md-tabs__item:nth-child(5) .md-tabs__link{transition-delay:80ms}.md-tabs__item:nth-child(6) .md-tabs__link{transition-delay:.1s}.md-tabs__item:nth-child(7) .md-tabs__link{transition-delay:.12s}.md-tabs__item:nth-child(8) .md-tabs__link{transition-delay:.14s}.md-tabs__item:nth-child(9) .md-tabs__link{transition-delay:.16s}.md-tabs__item:nth-child(10) .md-tabs__link{transition-delay:.18s}.md-tabs__item:nth-child(11) .md-tabs__link{transition-delay:.2s}.md-tabs__item:nth-child(12) .md-tabs__link{transition-delay:.22s}.md-tabs__item:nth-child(13) .md-tabs__link{transition-delay:.24s}.md-tabs__item:nth-child(14) .md-tabs__link{transition-delay:.26s}.md-tabs__item:nth-child(15) .md-tabs__link{transition-delay:.28s}.md-tabs__item:nth-child(16) .md-tabs__link{transition-delay:.3s}.md-tabs[hidden] .md-tabs__link{opacity:0;transform:translateY(50%);transition:transform 0ms .1s,opacity .1s}:root{--md-tag-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .md-tags:not([hidden]){display:inline-flex;flex-wrap:wrap;gap:.5em;margin-bottom:.75em;margin-top:-.125em}.md-typeset .md-tag{align-items:center;background:var(--md-default-fg-color--lightest);border-radius:2.4rem;display:inline-flex;font-size:.64rem;font-size:min(.8em,.64rem);font-weight:700;gap:.5em;letter-spacing:normal;line-height:1.6;padding:.3125em .78125em}.md-typeset .md-tag[href]{-webkit-tap-highlight-color:transparent;color:inherit;outline:none;transition:color 125ms,background-color 125ms}.md-typeset .md-tag[href]:focus,.md-typeset .md-tag[href]:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[id]>.md-typeset .md-tag{vertical-align:text-top}.md-typeset .md-tag-icon:before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-tag-icon);mask-image:var(--md-tag-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset .md-tag-icon[href]:focus:before,.md-typeset .md-tag-icon[href]:hover:before{background-color:var(--md-accent-bg-color)}@keyframes pulse{0%{transform:scale(.95)}75%{transform:scale(1)}to{transform:scale(.95)}}:root{--md-annotation-bg-icon:url('data:image/svg+xml;charset=utf-8,');--md-annotation-icon:url('data:image/svg+xml;charset=utf-8,');--md-tooltip-width:20rem}.md-tooltip{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);font-family:var(--md-text-font-family);left:clamp(var(--md-tooltip-0,0rem) + .8rem,var(--md-tooltip-x),100vw + var(--md-tooltip-0,0rem) + .8rem - var(--md-tooltip-width) - 2 * .8rem);max-width:calc(100vw - 1.6rem);opacity:0;position:absolute;top:var(--md-tooltip-y);transform:translateY(-.4rem);transition:transform 0ms .25s,opacity .25s,z-index .25s;width:var(--md-tooltip-width);z-index:0}.md-tooltip--active{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip--inline{font-weight:700;-webkit-user-select:none;user-select:none;width:auto}.md-tooltip--inline:not(.md-tooltip--active){transform:translateY(.2rem) scale(.9)}.md-tooltip--inline .md-tooltip__inner{font-size:.5rem;padding:.2rem .4rem}[hidden]+.md-tooltip--inline{display:none}.focus-visible>.md-tooltip,.md-tooltip:target{outline:var(--md-accent-fg-color) auto}.md-tooltip__inner{font-size:.64rem;padding:.8rem}.md-tooltip__inner.md-typeset>:first-child{margin-top:0}.md-tooltip__inner.md-typeset>:last-child{margin-bottom:0}.md-annotation{font-weight:400;outline:none;vertical-align:text-bottom;white-space:normal}[dir=rtl] .md-annotation{direction:rtl}code .md-annotation{font-family:var(--md-code-font-family);font-size:inherit}.md-annotation:not([hidden]){display:inline-block;line-height:1.25}.md-annotation__index{border-radius:.01px;cursor:pointer;display:inline-block;margin-left:.4ch;margin-right:.4ch;outline:none;overflow:hidden;position:relative;-webkit-user-select:none;user-select:none;vertical-align:text-top;z-index:0}.md-annotation .md-annotation__index{transition:z-index .25s}@media screen{.md-annotation__index{width:2.2ch}[data-md-visible]>.md-annotation__index{animation:pulse 2s infinite}.md-annotation__index:before{background:var(--md-default-bg-color);-webkit-mask-image:var(--md-annotation-bg-icon);mask-image:var(--md-annotation-bg-icon)}.md-annotation__index:after,.md-annotation__index:before{content:"";height:2.2ch;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:-.1ch;width:2.2ch;z-index:-1}.md-annotation__index:after{background-color:var(--md-default-fg-color--lighter);-webkit-mask-image:var(--md-annotation-icon);mask-image:var(--md-annotation-icon);transform:scale(1.0001);transition:background-color .25s,transform .25s}.md-tooltip--active+.md-annotation__index:after{transform:rotate(45deg)}.md-tooltip--active+.md-annotation__index:after,:hover>.md-annotation__index:after{background-color:var(--md-accent-fg-color)}}.md-tooltip--active+.md-annotation__index{animation-play-state:paused;transition-duration:0ms;z-index:2}.md-annotation__index [data-md-annotation-id]{display:inline-block}@media print{.md-annotation__index [data-md-annotation-id]{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);font-weight:700;padding:0 .6ch;white-space:nowrap}.md-annotation__index [data-md-annotation-id]:after{content:attr(data-md-annotation-id)}}.md-typeset .md-annotation-list{counter-reset:xxx;list-style:none}.md-typeset .md-annotation-list li{position:relative}[dir=ltr] .md-typeset .md-annotation-list li:before{left:-2.125em}[dir=rtl] .md-typeset .md-annotation-list li:before{right:-2.125em}.md-typeset .md-annotation-list li:before{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);content:counter(xxx);counter-increment:xxx;font-size:.8875em;font-weight:700;height:2ch;line-height:1.25;min-width:2ch;padding:0 .6ch;position:absolute;text-align:center;top:.25em}[dir=ltr] .md-top{margin-left:50%}[dir=rtl] .md-top{margin-right:50%}.md-top{background-color:var(--md-default-bg-color);border-radius:1.6rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color--light);cursor:pointer;display:block;font-size:.7rem;outline:none;padding:.4rem .8rem;position:fixed;top:3.2rem;transform:translate(-50%);transition:color 125ms,background-color 125ms,transform 125ms cubic-bezier(.4,0,.2,1),opacity 125ms;z-index:2}@media print{.md-top{display:none}}[dir=rtl] .md-top{transform:translate(50%)}.md-top[hidden]{opacity:0;pointer-events:none;transform:translate(-50%,.2rem);transition-duration:0ms}[dir=rtl] .md-top[hidden]{transform:translate(50%,.2rem)}.md-top:focus,.md-top:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top svg{display:inline-block;vertical-align:-.5em}@keyframes hoverfix{0%{pointer-events:none}}:root{--md-version-icon:url('data:image/svg+xml;charset=utf-8,')}.md-version{flex-shrink:0;font-size:.8rem;height:2.4rem}[dir=ltr] .md-version__current{margin-left:1.4rem;margin-right:.4rem}[dir=rtl] .md-version__current{margin-left:.4rem;margin-right:1.4rem}.md-version__current{color:inherit;cursor:pointer;outline:none;position:relative;top:.05rem}[dir=ltr] .md-version__current:after{margin-left:.4rem}[dir=rtl] .md-version__current:after{margin-right:.4rem}.md-version__current:after{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-image:var(--md-version-icon);mask-image:var(--md-version-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.4rem}.md-version__list{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);list-style-type:none;margin:.2rem .8rem;max-height:0;opacity:0;overflow:auto;padding:0;position:absolute;scroll-snap-type:y mandatory;top:.15rem;transition:max-height 0ms .5s,opacity .25s .25s;z-index:3}.md-version:focus-within .md-version__list,.md-version:hover .md-version__list{max-height:10rem;opacity:1;transition:max-height 0ms,opacity .25s}@media (hover:none),(pointer:coarse){.md-version:hover .md-version__list{animation:hoverfix .25s forwards}.md-version:focus-within .md-version__list{animation:none}}.md-version__item{line-height:1.8rem}[dir=ltr] .md-version__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-version__link{padding-left:1.2rem;padding-right:.6rem}.md-version__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:color .25s,background-color .25s;white-space:nowrap;width:100%}.md-version__link:focus,.md-version__link:hover{color:var(--md-accent-fg-color)}.md-version__link:focus{background-color:var(--md-default-fg-color--lightest)}:root{--md-admonition-icon--note:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--abstract:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--info:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--tip:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--success:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--question:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--warning:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--failure:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--danger:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--bug:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--quote:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .admonition,.md-typeset details{background-color:var(--md-admonition-bg-color);border:.075rem solid #448aff;border-radius:.2rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid;transition:box-shadow 125ms}@media print{.md-typeset .admonition,.md-typeset details{box-shadow:none}}.md-typeset .admonition:focus-within,.md-typeset details:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .admonition>*,.md-typeset details>*{box-sizing:border-box}.md-typeset .admonition .admonition,.md-typeset .admonition details,.md-typeset details .admonition,.md-typeset details details{margin-bottom:1em;margin-top:1em}.md-typeset .admonition .md-typeset__scrollwrap,.md-typeset details .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset .admonition .md-typeset__table,.md-typeset details .md-typeset__table{padding:0 .6rem}.md-typeset .admonition>.tabbed-set:only-child,.md-typeset details>.tabbed-set:only-child{margin-top:0}html .md-typeset .admonition>:last-child,html .md-typeset details>:last-child{margin-bottom:.6rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{padding-left:2rem;padding-right:.6rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{padding-left:.6rem;padding-right:2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-left-width:.2rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-right-width:.2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset .admonition-title,.md-typeset summary{background-color:#448aff1a;border:none;font-weight:700;margin:0 -.6rem;padding-bottom:.4rem;padding-top:.4rem;position:relative}html .md-typeset .admonition-title:last-child,html .md-typeset summary:last-child{margin-bottom:0}[dir=ltr] .md-typeset .admonition-title:before,[dir=ltr] .md-typeset summary:before{left:.6rem}[dir=rtl] .md-typeset .admonition-title:before,[dir=rtl] .md-typeset summary:before{right:.6rem}.md-typeset .admonition-title:before,.md-typeset summary:before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset .admonition-title code,.md-typeset summary code{box-shadow:0 0 0 .05rem var(--md-default-fg-color--lightest)}.md-typeset .admonition.note,.md-typeset details.note{border-color:#448aff}.md-typeset .admonition.note:focus-within,.md-typeset details.note:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .note>.admonition-title,.md-typeset .note>summary{background-color:#448aff1a}.md-typeset .note>.admonition-title:before,.md-typeset .note>summary:before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note)}.md-typeset .note>.admonition-title:after,.md-typeset .note>summary:after{color:#448aff}.md-typeset .admonition.abstract,.md-typeset details.abstract{border-color:#00b0ff}.md-typeset .admonition.abstract:focus-within,.md-typeset details.abstract:focus-within{box-shadow:0 0 0 .2rem #00b0ff1a}.md-typeset .abstract>.admonition-title,.md-typeset .abstract>summary{background-color:#00b0ff1a}.md-typeset .abstract>.admonition-title:before,.md-typeset .abstract>summary:before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract)}.md-typeset .abstract>.admonition-title:after,.md-typeset .abstract>summary:after{color:#00b0ff}.md-typeset .admonition.info,.md-typeset details.info{border-color:#00b8d4}.md-typeset .admonition.info:focus-within,.md-typeset details.info:focus-within{box-shadow:0 0 0 .2rem #00b8d41a}.md-typeset .info>.admonition-title,.md-typeset .info>summary{background-color:#00b8d41a}.md-typeset .info>.admonition-title:before,.md-typeset .info>summary:before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info)}.md-typeset .info>.admonition-title:after,.md-typeset .info>summary:after{color:#00b8d4}.md-typeset .admonition.tip,.md-typeset details.tip{border-color:#00bfa5}.md-typeset .admonition.tip:focus-within,.md-typeset details.tip:focus-within{box-shadow:0 0 0 .2rem #00bfa51a}.md-typeset .tip>.admonition-title,.md-typeset .tip>summary{background-color:#00bfa51a}.md-typeset .tip>.admonition-title:before,.md-typeset .tip>summary:before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip)}.md-typeset .tip>.admonition-title:after,.md-typeset .tip>summary:after{color:#00bfa5}.md-typeset .admonition.success,.md-typeset details.success{border-color:#00c853}.md-typeset .admonition.success:focus-within,.md-typeset details.success:focus-within{box-shadow:0 0 0 .2rem #00c8531a}.md-typeset .success>.admonition-title,.md-typeset .success>summary{background-color:#00c8531a}.md-typeset .success>.admonition-title:before,.md-typeset .success>summary:before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success)}.md-typeset .success>.admonition-title:after,.md-typeset .success>summary:after{color:#00c853}.md-typeset .admonition.question,.md-typeset details.question{border-color:#64dd17}.md-typeset .admonition.question:focus-within,.md-typeset details.question:focus-within{box-shadow:0 0 0 .2rem #64dd171a}.md-typeset .question>.admonition-title,.md-typeset .question>summary{background-color:#64dd171a}.md-typeset .question>.admonition-title:before,.md-typeset .question>summary:before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question)}.md-typeset .question>.admonition-title:after,.md-typeset .question>summary:after{color:#64dd17}.md-typeset .admonition.warning,.md-typeset details.warning{border-color:#ff9100}.md-typeset .admonition.warning:focus-within,.md-typeset details.warning:focus-within{box-shadow:0 0 0 .2rem #ff91001a}.md-typeset .warning>.admonition-title,.md-typeset .warning>summary{background-color:#ff91001a}.md-typeset .warning>.admonition-title:before,.md-typeset .warning>summary:before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning)}.md-typeset .warning>.admonition-title:after,.md-typeset .warning>summary:after{color:#ff9100}.md-typeset .admonition.failure,.md-typeset details.failure{border-color:#ff5252}.md-typeset .admonition.failure:focus-within,.md-typeset details.failure:focus-within{box-shadow:0 0 0 .2rem #ff52521a}.md-typeset .failure>.admonition-title,.md-typeset .failure>summary{background-color:#ff52521a}.md-typeset .failure>.admonition-title:before,.md-typeset .failure>summary:before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure)}.md-typeset .failure>.admonition-title:after,.md-typeset .failure>summary:after{color:#ff5252}.md-typeset .admonition.danger,.md-typeset details.danger{border-color:#ff1744}.md-typeset .admonition.danger:focus-within,.md-typeset details.danger:focus-within{box-shadow:0 0 0 .2rem #ff17441a}.md-typeset .danger>.admonition-title,.md-typeset .danger>summary{background-color:#ff17441a}.md-typeset .danger>.admonition-title:before,.md-typeset .danger>summary:before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger)}.md-typeset .danger>.admonition-title:after,.md-typeset .danger>summary:after{color:#ff1744}.md-typeset .admonition.bug,.md-typeset details.bug{border-color:#f50057}.md-typeset .admonition.bug:focus-within,.md-typeset details.bug:focus-within{box-shadow:0 0 0 .2rem #f500571a}.md-typeset .bug>.admonition-title,.md-typeset .bug>summary{background-color:#f500571a}.md-typeset .bug>.admonition-title:before,.md-typeset .bug>summary:before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug)}.md-typeset .bug>.admonition-title:after,.md-typeset .bug>summary:after{color:#f50057}.md-typeset .admonition.example,.md-typeset details.example{border-color:#7c4dff}.md-typeset .admonition.example:focus-within,.md-typeset details.example:focus-within{box-shadow:0 0 0 .2rem #7c4dff1a}.md-typeset .example>.admonition-title,.md-typeset .example>summary{background-color:#7c4dff1a}.md-typeset .example>.admonition-title:before,.md-typeset .example>summary:before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example)}.md-typeset .example>.admonition-title:after,.md-typeset .example>summary:after{color:#7c4dff}.md-typeset .admonition.quote,.md-typeset details.quote{border-color:#9e9e9e}.md-typeset .admonition.quote:focus-within,.md-typeset details.quote:focus-within{box-shadow:0 0 0 .2rem #9e9e9e1a}.md-typeset .quote>.admonition-title,.md-typeset .quote>summary{background-color:#9e9e9e1a}.md-typeset .quote>.admonition-title:before,.md-typeset .quote>summary:before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote)}.md-typeset .quote>.admonition-title:after,.md-typeset .quote>summary:after{color:#9e9e9e}:root{--md-footnotes-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .footnote{color:var(--md-default-fg-color--light);font-size:.64rem}[dir=ltr] .md-typeset .footnote>ol{margin-left:0}[dir=rtl] .md-typeset .footnote>ol{margin-right:0}.md-typeset .footnote>ol>li{transition:color 125ms}.md-typeset .footnote>ol>li:target{color:var(--md-default-fg-color)}.md-typeset .footnote>ol>li:focus-within .footnote-backref{opacity:1;transform:translateX(0);transition:none}.md-typeset .footnote>ol>li:hover .footnote-backref,.md-typeset .footnote>ol>li:target .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li>:first-child{margin-top:0}.md-typeset .footnote-ref{font-size:.75em;font-weight:700}html .md-typeset .footnote-ref{outline-offset:.1rem}.md-typeset [id^="fnref:"]:target>.footnote-ref{outline:auto}.md-typeset .footnote-backref{color:var(--md-typeset-a-color);display:inline-block;font-size:0;opacity:0;transform:translateX(.25rem);transition:color .25s,transform .25s .25s,opacity 125ms .25s;vertical-align:text-bottom}@media print{.md-typeset .footnote-backref{color:var(--md-typeset-a-color);opacity:1;transform:translateX(0)}}[dir=rtl] .md-typeset .footnote-backref{transform:translateX(-.25rem)}.md-typeset .footnote-backref:hover{color:var(--md-accent-fg-color)}.md-typeset .footnote-backref:before{background-color:currentcolor;content:"";display:inline-block;height:.8rem;-webkit-mask-image:var(--md-footnotes-icon);mask-image:var(--md-footnotes-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.8rem}[dir=rtl] .md-typeset .footnote-backref:before svg{transform:scaleX(-1)}[dir=ltr] .md-typeset .headerlink{margin-left:.5rem}[dir=rtl] .md-typeset .headerlink{margin-right:.5rem}.md-typeset .headerlink{color:var(--md-default-fg-color--lighter);display:inline-block;opacity:0;transition:color .25s,opacity 125ms}@media print{.md-typeset .headerlink{display:none}}.md-typeset .headerlink:focus,.md-typeset :hover>.headerlink,.md-typeset :target>.headerlink{opacity:1;transition:color .25s,opacity 125ms}.md-typeset .headerlink:focus,.md-typeset .headerlink:hover,.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset :target{--md-scroll-margin:3.6rem;--md-scroll-offset:0rem;scroll-margin-top:calc(var(--md-scroll-margin) - var(--md-scroll-offset))}@media screen and (min-width:76.25em){.md-header--lifted~.md-container .md-typeset :target{--md-scroll-margin:6rem}}.md-typeset h1:target,.md-typeset h2:target,.md-typeset h3:target{--md-scroll-offset:0.2rem}.md-typeset h4:target{--md-scroll-offset:0.15rem}.md-typeset div.arithmatex{overflow:auto}@media screen and (max-width:44.984375em){.md-typeset div.arithmatex{margin:0 -.8rem}}.md-typeset div.arithmatex>*{margin-left:auto!important;margin-right:auto!important;padding:0 .8rem;touch-action:auto;width:-webkit-min-content;width:min-content}.md-typeset div.arithmatex>* mjx-container{margin:0!important}.md-typeset del.critic{background-color:var(--md-typeset-del-color)}.md-typeset del.critic,.md-typeset ins.critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset ins.critic{background-color:var(--md-typeset-ins-color)}.md-typeset .critic.comment{-webkit-box-decoration-break:clone;box-decoration-break:clone;color:var(--md-code-hl-comment-color)}.md-typeset .critic.comment:before{content:"/* "}.md-typeset .critic.comment:after{content:" */"}.md-typeset .critic.block{box-shadow:none;display:block;margin:1em 0;overflow:auto;padding-left:.8rem;padding-right:.8rem}.md-typeset .critic.block>:first-child{margin-top:.5em}.md-typeset .critic.block>:last-child{margin-bottom:.5em}:root{--md-details-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset details{display:flow-root;overflow:visible;padding-top:0}.md-typeset details[open]>summary:after{transform:rotate(90deg)}.md-typeset details:not([open]){box-shadow:none;padding-bottom:0}.md-typeset details:not([open])>summary{border-radius:.1rem}[dir=ltr] .md-typeset summary{padding-right:1.8rem}[dir=rtl] .md-typeset summary{padding-left:1.8rem}[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset summary{cursor:pointer;display:block;min-height:1rem}.md-typeset summary.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset summary:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[dir=ltr] .md-typeset summary:after{right:.4rem}[dir=rtl] .md-typeset summary:after{left:.4rem}.md-typeset summary:after{background-color:currentcolor;content:"";height:1rem;-webkit-mask-image:var(--md-details-icon);mask-image:var(--md-details-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;transform:rotate(0deg);transition:transform .25s;width:1rem}[dir=rtl] .md-typeset summary:after{transform:rotate(180deg)}.md-typeset summary::marker{display:none}.md-typeset summary::-webkit-details-marker{display:none}.md-typeset .emojione,.md-typeset .gemoji,.md-typeset .twemoji{--md-icon-size:1.125em;display:inline-flex;height:var(--md-icon-size);vertical-align:text-top}.md-typeset .emojione svg,.md-typeset .gemoji svg,.md-typeset .twemoji svg{fill:currentcolor;max-height:100%;width:var(--md-icon-size)}.md-typeset .lg,.md-typeset .xl,.md-typeset .xxl,.md-typeset .xxxl{vertical-align:text-bottom}.md-typeset .middle{vertical-align:middle}.md-typeset .lg{--md-icon-size:1.5em}.md-typeset .xl{--md-icon-size:2.25em}.md-typeset .xxl{--md-icon-size:3em}.md-typeset .xxxl{--md-icon-size:4em}.highlight .o,.highlight .ow{color:var(--md-code-hl-operator-color)}.highlight .p{color:var(--md-code-hl-punctuation-color)}.highlight .cpf,.highlight .l,.highlight .s,.highlight .s1,.highlight .s2,.highlight .sb,.highlight .sc,.highlight .si,.highlight .ss{color:var(--md-code-hl-string-color)}.highlight .cp,.highlight .se,.highlight .sh,.highlight .sr,.highlight .sx{color:var(--md-code-hl-special-color)}.highlight .il,.highlight .m,.highlight .mb,.highlight .mf,.highlight .mh,.highlight .mi,.highlight .mo{color:var(--md-code-hl-number-color)}.highlight .k,.highlight .kd,.highlight .kn,.highlight .kp,.highlight .kr,.highlight .kt{color:var(--md-code-hl-keyword-color)}.highlight .kc,.highlight .n{color:var(--md-code-hl-name-color)}.highlight .bp,.highlight .nb,.highlight .no{color:var(--md-code-hl-constant-color)}.highlight .nc,.highlight .ne,.highlight .nf,.highlight .nn{color:var(--md-code-hl-function-color)}.highlight .nd,.highlight .ni,.highlight .nl,.highlight .nt{color:var(--md-code-hl-keyword-color)}.highlight .c,.highlight .c1,.highlight .ch,.highlight .cm,.highlight .cs,.highlight .sd{color:var(--md-code-hl-comment-color)}.highlight .na,.highlight .nv,.highlight .vc,.highlight .vg,.highlight .vi{color:var(--md-code-hl-variable-color)}.highlight .ge,.highlight .gh,.highlight .go,.highlight .gp,.highlight .gr,.highlight .gs,.highlight .gt,.highlight .gu{color:var(--md-code-hl-generic-color)}.highlight .gd,.highlight .gi{border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight .gd{background-color:var(--md-typeset-del-color)}.highlight .gi{background-color:var(--md-typeset-ins-color)}.highlight .hll{background-color:var(--md-code-hl-color--light);box-shadow:2px 0 0 0 var(--md-code-hl-color) inset;display:block;margin:0 -1.1764705882em;padding:0 1.1764705882em}.highlight span.filename{background-color:var(--md-code-bg-color);border-bottom:.05rem solid var(--md-default-fg-color--lightest);border-top-left-radius:.1rem;border-top-right-radius:.1rem;display:flow-root;font-size:.85em;font-weight:700;margin-top:1em;padding:.6617647059em 1.1764705882em;position:relative}.highlight span.filename+pre{margin-top:0}.highlight span.filename+pre>code{border-top-left-radius:0;border-top-right-radius:0}.highlight [data-linenos]:before{background-color:var(--md-code-bg-color);box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;color:var(--md-default-fg-color--light);content:attr(data-linenos);float:left;left:-1.1764705882em;margin-left:-1.1764705882em;margin-right:1.1764705882em;padding-left:1.1764705882em;position:sticky;-webkit-user-select:none;user-select:none;z-index:3}.highlight code a[id]{position:absolute;visibility:hidden}.highlight code[data-md-copying]{display:block}.highlight code[data-md-copying] .hll{display:contents}.highlight code[data-md-copying] .md-annotation{display:none}.highlighttable{display:flow-root}.highlighttable tbody,.highlighttable td{display:block;padding:0}.highlighttable tr{display:flex}.highlighttable pre{margin:0}.highlighttable th.filename{flex-grow:1;padding:0;text-align:left}.highlighttable th.filename span.filename{margin-top:0}.highlighttable .linenos{background-color:var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-top-left-radius:.1rem;font-size:.85em;padding:.7720588235em 0 .7720588235em 1.1764705882em;-webkit-user-select:none;user-select:none}.highlighttable .linenodiv{box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset}.highlighttable .linenodiv pre{color:var(--md-default-fg-color--light);text-align:right}.highlighttable .linenodiv span[class]{padding-right:.5882352941em}.highlighttable .code{flex:1;min-width:0}.linenodiv a{color:inherit}.md-typeset .highlighttable{direction:ltr;margin:1em 0}.md-typeset .highlighttable>tbody>tr>.code>div>pre>code{border-bottom-left-radius:0;border-top-left-radius:0}.md-typeset .highlight+.result{border:.05rem solid var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-bottom-right-radius:.1rem;border-top-width:.1rem;margin-top:-1.125em;overflow:visible;padding:0 1em}.md-typeset .highlight+.result:after{clear:both;content:"";display:block}@media screen and (max-width:44.984375em){.md-content__inner>.highlight{margin:1em -.8rem}.md-content__inner>.highlight>.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.code>div>pre>code,.md-content__inner>.highlight>.highlighttable>tbody>tr>.filename span.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.linenos,.md-content__inner>.highlight>pre>code{border-radius:0}.md-content__inner>.highlight+.result{border-left-width:0;border-radius:0;border-right-width:0;margin-left:-.8rem;margin-right:-.8rem}}.md-typeset .keys kbd:after,.md-typeset .keys kbd:before{-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys span{color:var(--md-default-fg-color--light);padding:0 .2em}.md-typeset .keys .key-alt:before,.md-typeset .keys .key-left-alt:before,.md-typeset .keys .key-right-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-command:before,.md-typeset .keys .key-left-command:before,.md-typeset .keys .key-right-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-control:before,.md-typeset .keys .key-left-control:before,.md-typeset .keys .key-right-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-left-meta:before,.md-typeset .keys .key-meta:before,.md-typeset .keys .key-right-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-left-option:before,.md-typeset .keys .key-option:before,.md-typeset .keys .key-right-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-left-shift:before,.md-typeset .keys .key-right-shift:before,.md-typeset .keys .key-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-left-super:before,.md-typeset .keys .key-right-super:before,.md-typeset .keys .key-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-left-windows:before,.md-typeset .keys .key-right-windows:before,.md-typeset .keys .key-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-arrow-down:before{content:"↓";padding-right:.4em}.md-typeset .keys .key-arrow-left:before{content:"←";padding-right:.4em}.md-typeset .keys .key-arrow-right:before{content:"→";padding-right:.4em}.md-typeset .keys .key-arrow-up:before{content:"↑";padding-right:.4em}.md-typeset .keys .key-backspace:before{content:"⌫";padding-right:.4em}.md-typeset .keys .key-backtab:before{content:"⇤";padding-right:.4em}.md-typeset .keys .key-caps-lock:before{content:"⇪";padding-right:.4em}.md-typeset .keys .key-clear:before{content:"⌧";padding-right:.4em}.md-typeset .keys .key-context-menu:before{content:"☰";padding-right:.4em}.md-typeset .keys .key-delete:before{content:"⌦";padding-right:.4em}.md-typeset .keys .key-eject:before{content:"⏏";padding-right:.4em}.md-typeset .keys .key-end:before{content:"⤓";padding-right:.4em}.md-typeset .keys .key-escape:before{content:"⎋";padding-right:.4em}.md-typeset .keys .key-home:before{content:"⤒";padding-right:.4em}.md-typeset .keys .key-insert:before{content:"⎀";padding-right:.4em}.md-typeset .keys .key-page-down:before{content:"⇟";padding-right:.4em}.md-typeset .keys .key-page-up:before{content:"⇞";padding-right:.4em}.md-typeset .keys .key-print-screen:before{content:"⎙";padding-right:.4em}.md-typeset .keys .key-tab:after{content:"⇥";padding-left:.4em}.md-typeset .keys .key-num-enter:after{content:"⌤";padding-left:.4em}.md-typeset .keys .key-enter:after{content:"⏎";padding-left:.4em}:root{--md-tabbed-icon--prev:url('data:image/svg+xml;charset=utf-8,');--md-tabbed-icon--next:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .tabbed-set{border-radius:.1rem;display:flex;flex-flow:column wrap;margin:1em 0;position:relative}.md-typeset .tabbed-set>input{height:0;opacity:0;position:absolute;width:0}.md-typeset .tabbed-set>input:target{--md-scroll-offset:0.625em}.md-typeset .tabbed-set>input.focus-visible~.tabbed-labels:before{background-color:var(--md-accent-fg-color)}.md-typeset .tabbed-labels{-ms-overflow-style:none;box-shadow:0 -.05rem var(--md-default-fg-color--lightest) inset;display:flex;max-width:100%;overflow:auto;scrollbar-width:none}@media print{.md-typeset .tabbed-labels{display:contents}}@media screen{.js .md-typeset .tabbed-labels{position:relative}.js .md-typeset .tabbed-labels:before{background:var(--md-default-fg-color);bottom:0;content:"";display:block;height:2px;left:0;position:absolute;transform:translateX(var(--md-indicator-x));transition:width 225ms,background-color .25s,transform .25s;transition-timing-function:cubic-bezier(.4,0,.2,1);width:var(--md-indicator-width)}}.md-typeset .tabbed-labels::-webkit-scrollbar{display:none}.md-typeset .tabbed-labels>label{border-bottom:.1rem solid #0000;border-radius:.1rem .1rem 0 0;color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;font-size:.64rem;font-weight:700;padding:.78125em 1.25em .625em;scroll-margin-inline-start:1rem;transition:background-color .25s,color .25s;white-space:nowrap;width:auto}@media print{.md-typeset .tabbed-labels>label:first-child{order:1}.md-typeset .tabbed-labels>label:nth-child(2){order:2}.md-typeset .tabbed-labels>label:nth-child(3){order:3}.md-typeset .tabbed-labels>label:nth-child(4){order:4}.md-typeset .tabbed-labels>label:nth-child(5){order:5}.md-typeset .tabbed-labels>label:nth-child(6){order:6}.md-typeset .tabbed-labels>label:nth-child(7){order:7}.md-typeset .tabbed-labels>label:nth-child(8){order:8}.md-typeset .tabbed-labels>label:nth-child(9){order:9}.md-typeset .tabbed-labels>label:nth-child(10){order:10}.md-typeset .tabbed-labels>label:nth-child(11){order:11}.md-typeset .tabbed-labels>label:nth-child(12){order:12}.md-typeset .tabbed-labels>label:nth-child(13){order:13}.md-typeset .tabbed-labels>label:nth-child(14){order:14}.md-typeset .tabbed-labels>label:nth-child(15){order:15}.md-typeset .tabbed-labels>label:nth-child(16){order:16}.md-typeset .tabbed-labels>label:nth-child(17){order:17}.md-typeset .tabbed-labels>label:nth-child(18){order:18}.md-typeset .tabbed-labels>label:nth-child(19){order:19}.md-typeset .tabbed-labels>label:nth-child(20){order:20}}.md-typeset .tabbed-labels>label:hover{color:var(--md-default-fg-color)}.md-typeset .tabbed-labels>label>[href]:first-child{color:inherit}.md-typeset .tabbed-labels--linked>label{padding:0}.md-typeset .tabbed-labels--linked>label>a{display:block;padding:.78125em 1.25em .625em}.md-typeset .tabbed-content{width:100%}@media print{.md-typeset .tabbed-content{display:contents}}.md-typeset .tabbed-block{display:none}@media print{.md-typeset .tabbed-block{display:block}.md-typeset .tabbed-block:first-child{order:1}.md-typeset .tabbed-block:nth-child(2){order:2}.md-typeset .tabbed-block:nth-child(3){order:3}.md-typeset .tabbed-block:nth-child(4){order:4}.md-typeset .tabbed-block:nth-child(5){order:5}.md-typeset .tabbed-block:nth-child(6){order:6}.md-typeset .tabbed-block:nth-child(7){order:7}.md-typeset .tabbed-block:nth-child(8){order:8}.md-typeset .tabbed-block:nth-child(9){order:9}.md-typeset .tabbed-block:nth-child(10){order:10}.md-typeset .tabbed-block:nth-child(11){order:11}.md-typeset .tabbed-block:nth-child(12){order:12}.md-typeset .tabbed-block:nth-child(13){order:13}.md-typeset .tabbed-block:nth-child(14){order:14}.md-typeset .tabbed-block:nth-child(15){order:15}.md-typeset .tabbed-block:nth-child(16){order:16}.md-typeset .tabbed-block:nth-child(17){order:17}.md-typeset .tabbed-block:nth-child(18){order:18}.md-typeset .tabbed-block:nth-child(19){order:19}.md-typeset .tabbed-block:nth-child(20){order:20}}.md-typeset .tabbed-block>.highlight:first-child>pre,.md-typeset .tabbed-block>pre:first-child{margin:0}.md-typeset .tabbed-block>.highlight:first-child>pre>code,.md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child>.filename{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable{margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.filename span.filename,.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.linenos{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.code>div>pre>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child+.result{margin-top:-.125em}.md-typeset .tabbed-block>.tabbed-set{margin:0}.md-typeset .tabbed-button{align-self:center;border-radius:100%;color:var(--md-default-fg-color--light);cursor:pointer;display:block;height:.9rem;margin-top:.1rem;pointer-events:auto;transition:background-color .25s;width:.9rem}.md-typeset .tabbed-button:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .tabbed-button:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-tabbed-icon--prev);mask-image:var(--md-tabbed-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color .25s,transform .25s;width:100%}.md-typeset .tabbed-control{background:linear-gradient(to right,var(--md-default-bg-color) 60%,#0000);display:flex;height:1.9rem;justify-content:start;pointer-events:none;position:absolute;transition:opacity 125ms;width:1.2rem}[dir=rtl] .md-typeset .tabbed-control{transform:rotate(180deg)}.md-typeset .tabbed-control[hidden]{opacity:0}.md-typeset .tabbed-control--next{background:linear-gradient(to left,var(--md-default-bg-color) 60%,#0000);justify-content:end;right:0}.md-typeset .tabbed-control--next .tabbed-button:after{-webkit-mask-image:var(--md-tabbed-icon--next);mask-image:var(--md-tabbed-icon--next)}@media screen and (max-width:44.984375em){[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels{margin:0 -.8rem;max-width:100vw;scroll-padding-inline-start:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels:after{content:""}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-right:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-left:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-right:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{width:2rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-left:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-right:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-left:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{width:2rem}}@media screen{.md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){color:var(--md-default-fg-color)}.md-typeset .no-js .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .no-js .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .no-js .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .no-js .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .no-js .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .no-js .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .no-js .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .no-js .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .no-js .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .no-js .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .no-js .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .no-js .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .no-js .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .no-js .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .no-js .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .no-js .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .no-js .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .no-js .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .no-js .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .no-js .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.no-js .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.no-js .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.no-js .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.no-js .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.no-js .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.no-js .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.no-js .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.no-js .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.no-js .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.no-js .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.no-js .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.no-js .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.no-js .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.no-js .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.no-js .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.no-js .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.no-js .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.no-js .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.no-js .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.no-js .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){border-color:var(--md-default-fg-color)}}.md-typeset .tabbed-set>input:first-child.focus-visible~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10).focus-visible~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11).focus-visible~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12).focus-visible~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13).focus-visible~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14).focus-visible~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15).focus-visible~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16).focus-visible~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17).focus-visible~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18).focus-visible~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19).focus-visible~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2).focus-visible~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20).focus-visible~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3).focus-visible~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4).focus-visible~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5).focus-visible~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6).focus-visible~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7).focus-visible~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8).focus-visible~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9).focus-visible~.tabbed-labels>:nth-child(9){color:var(--md-accent-fg-color)}.md-typeset .tabbed-set>input:first-child:checked~.tabbed-content>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-content>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-content>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-content>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-content>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-content>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-content>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-content>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-content>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-content>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-content>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-content>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-content>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-content>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-content>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-content>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-content>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-content>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-content>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-content>:nth-child(9){display:block}:root{--md-tasklist-icon:url('data:image/svg+xml;charset=utf-8,');--md-tasklist-icon--checked:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .task-list-item{list-style-type:none;position:relative}[dir=ltr] .md-typeset .task-list-item [type=checkbox]{left:-2em}[dir=rtl] .md-typeset .task-list-item [type=checkbox]{right:-2em}.md-typeset .task-list-item [type=checkbox]{position:absolute;top:.45em}.md-typeset .task-list-control [type=checkbox]{opacity:0;z-index:-1}[dir=ltr] .md-typeset .task-list-indicator:before{left:-1.5em}[dir=rtl] .md-typeset .task-list-indicator:before{right:-1.5em}.md-typeset .task-list-indicator:before{background-color:var(--md-default-fg-color--lightest);content:"";height:1.25em;-webkit-mask-image:var(--md-tasklist-icon);mask-image:var(--md-tasklist-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.15em;width:1.25em}.md-typeset [type=checkbox]:checked+.task-list-indicator:before{background-color:#00e676;-webkit-mask-image:var(--md-tasklist-icon--checked);mask-image:var(--md-tasklist-icon--checked)}:root>*{--md-mermaid-font-family:var(--md-text-font-family),sans-serif;--md-mermaid-edge-color:var(--md-code-fg-color);--md-mermaid-node-bg-color:var(--md-accent-fg-color--transparent);--md-mermaid-node-fg-color:var(--md-accent-fg-color);--md-mermaid-label-bg-color:var(--md-default-bg-color);--md-mermaid-label-fg-color:var(--md-code-fg-color);--md-mermaid-sequence-actor-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actor-fg-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-actor-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-actor-line-color:var(--md-default-fg-color--lighter);--md-mermaid-sequence-actorman-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actorman-line-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-box-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-box-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-label-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-label-fg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-loop-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-loop-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-loop-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-message-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-message-line-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-note-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-border-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-number-bg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-number-fg-color:var(--md-accent-bg-color)}.mermaid{line-height:normal;margin:1em 0}.md-typeset .grid{grid-gap:.4rem;display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,16rem),1fr));margin:1em 0}.md-typeset .grid.cards>ol,.md-typeset .grid.cards>ul{display:contents}.md-typeset .grid.cards>ol>li,.md-typeset .grid.cards>ul>li,.md-typeset .grid>.card{border:.05rem solid var(--md-default-fg-color--lightest);border-radius:.1rem;display:block;margin:0;padding:.8rem;transition:border .25s,box-shadow .25s}.md-typeset .grid.cards>ol>li:focus-within,.md-typeset .grid.cards>ol>li:hover,.md-typeset .grid.cards>ul>li:focus-within,.md-typeset .grid.cards>ul>li:hover,.md-typeset .grid>.card:focus-within,.md-typeset .grid>.card:hover{border-color:#0000;box-shadow:var(--md-shadow-z2)}.md-typeset .grid.cards>ol>li>hr,.md-typeset .grid.cards>ul>li>hr,.md-typeset .grid>.card>hr{margin-bottom:1em;margin-top:1em}.md-typeset .grid.cards>ol>li>:first-child,.md-typeset .grid.cards>ul>li>:first-child,.md-typeset .grid>.card>:first-child{margin-top:0}.md-typeset .grid.cards>ol>li>:last-child,.md-typeset .grid.cards>ul>li>:last-child,.md-typeset .grid>.card>:last-child{margin-bottom:0}.md-typeset .grid>*,.md-typeset .grid>.admonition,.md-typeset .grid>.highlight>*,.md-typeset .grid>.highlighttable,.md-typeset .grid>.md-typeset details,.md-typeset .grid>details,.md-typeset .grid>pre{margin-bottom:0;margin-top:0}.md-typeset .grid>.highlight>pre:only-child,.md-typeset .grid>.highlight>pre>code,.md-typeset .grid>.highlighttable,.md-typeset .grid>.highlighttable>tbody,.md-typeset .grid>.highlighttable>tbody>tr,.md-typeset .grid>.highlighttable>tbody>tr>.code,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre>code{height:100%}.md-typeset .grid>.tabbed-set{margin-bottom:0;margin-top:0}@media screen and (min-width:45em){[dir=ltr] .md-typeset .inline{float:left}[dir=rtl] .md-typeset .inline{float:right}[dir=ltr] .md-typeset .inline{margin-right:.8rem}[dir=rtl] .md-typeset .inline{margin-left:.8rem}.md-typeset .inline{margin-bottom:.8rem;margin-top:0;width:11.7rem}[dir=ltr] .md-typeset .inline.end{float:right}[dir=rtl] .md-typeset .inline.end{float:left}[dir=ltr] .md-typeset .inline.end{margin-left:.8rem;margin-right:0}[dir=rtl] .md-typeset .inline.end{margin-left:0;margin-right:.8rem}} \ No newline at end of file diff --git a/assets/stylesheets/palette.ab4e12ef.min.css b/assets/stylesheets/palette.ab4e12ef.min.css new file mode 100644 index 00000000..75aaf842 --- /dev/null +++ b/assets/stylesheets/palette.ab4e12ef.min.css @@ -0,0 +1 @@ +@media screen{[data-md-color-scheme=slate]{--md-default-fg-color:hsla(var(--md-hue),15%,90%,0.82);--md-default-fg-color--light:hsla(var(--md-hue),15%,90%,0.56);--md-default-fg-color--lighter:hsla(var(--md-hue),15%,90%,0.32);--md-default-fg-color--lightest:hsla(var(--md-hue),15%,90%,0.12);--md-default-bg-color:hsla(var(--md-hue),15%,14%,1);--md-default-bg-color--light:hsla(var(--md-hue),15%,14%,0.54);--md-default-bg-color--lighter:hsla(var(--md-hue),15%,14%,0.26);--md-default-bg-color--lightest:hsla(var(--md-hue),15%,14%,0.07);--md-code-fg-color:hsla(var(--md-hue),18%,86%,0.82);--md-code-bg-color:hsla(var(--md-hue),15%,18%,1);--md-code-bg-color--light:hsla(var(--md-hue),15%,18%,0.9);--md-code-bg-color--lighter:hsla(var(--md-hue),15%,18%,0.54);--md-code-hl-color:#2977ff;--md-code-hl-color--light:#2977ff1a;--md-code-hl-number-color:#e6695b;--md-code-hl-special-color:#f06090;--md-code-hl-function-color:#c973d9;--md-code-hl-constant-color:#9383e2;--md-code-hl-keyword-color:#6791e0;--md-code-hl-string-color:#2fb170;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-kbd-color:hsla(var(--md-hue),15%,90%,0.12);--md-typeset-kbd-accent-color:hsla(var(--md-hue),15%,90%,0.2);--md-typeset-kbd-border-color:hsla(var(--md-hue),15%,14%,1);--md-typeset-mark-color:#4287ff4d;--md-typeset-table-color:hsla(var(--md-hue),15%,95%,0.12);--md-typeset-table-color--light:hsla(var(--md-hue),15%,95%,0.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-footer-bg-color:hsla(var(--md-hue),15%,10%,0.87);--md-footer-bg-color--dark:hsla(var(--md-hue),15%,8%,1);--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #00000040,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0006,0 0 0.05rem #00000059;color-scheme:dark}[data-md-color-scheme=slate] img[src$="#gh-light-mode-only"],[data-md-color-scheme=slate] img[src$="#only-light"]{display:none}[data-md-color-scheme=slate][data-md-color-primary=pink]{--md-typeset-a-color:#ed5487}[data-md-color-scheme=slate][data-md-color-primary=purple]{--md-typeset-a-color:#c46fd3}[data-md-color-scheme=slate][data-md-color-primary=deep-purple]{--md-typeset-a-color:#a47bea}[data-md-color-scheme=slate][data-md-color-primary=indigo]{--md-typeset-a-color:#5488e8}[data-md-color-scheme=slate][data-md-color-primary=teal]{--md-typeset-a-color:#00ccb8}[data-md-color-scheme=slate][data-md-color-primary=green]{--md-typeset-a-color:#71c174}[data-md-color-scheme=slate][data-md-color-primary=deep-orange]{--md-typeset-a-color:#ff764d}[data-md-color-scheme=slate][data-md-color-primary=brown]{--md-typeset-a-color:#c1775c}[data-md-color-scheme=slate][data-md-color-primary=black],[data-md-color-scheme=slate][data-md-color-primary=blue-grey],[data-md-color-scheme=slate][data-md-color-primary=grey],[data-md-color-scheme=slate][data-md-color-primary=white]{--md-typeset-a-color:#5e8bde}[data-md-color-switching] *,[data-md-color-switching] :after,[data-md-color-switching] :before{transition-duration:0ms!important}}[data-md-color-accent=red]{--md-accent-fg-color:#ff1947;--md-accent-fg-color--transparent:#ff19471a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=pink]{--md-accent-fg-color:#f50056;--md-accent-fg-color--transparent:#f500561a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=purple]{--md-accent-fg-color:#df41fb;--md-accent-fg-color--transparent:#df41fb1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=deep-purple]{--md-accent-fg-color:#7c4dff;--md-accent-fg-color--transparent:#7c4dff1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=indigo]{--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=blue]{--md-accent-fg-color:#4287ff;--md-accent-fg-color--transparent:#4287ff1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=light-blue]{--md-accent-fg-color:#0091eb;--md-accent-fg-color--transparent:#0091eb1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=cyan]{--md-accent-fg-color:#00bad6;--md-accent-fg-color--transparent:#00bad61a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=teal]{--md-accent-fg-color:#00bda4;--md-accent-fg-color--transparent:#00bda41a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=green]{--md-accent-fg-color:#00c753;--md-accent-fg-color--transparent:#00c7531a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=light-green]{--md-accent-fg-color:#63de17;--md-accent-fg-color--transparent:#63de171a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=lime]{--md-accent-fg-color:#b0eb00;--md-accent-fg-color--transparent:#b0eb001a;--md-accent-bg-color:#000000de;--md-accent-bg-color--light:#0000008a}[data-md-color-accent=yellow]{--md-accent-fg-color:#ffd500;--md-accent-fg-color--transparent:#ffd5001a;--md-accent-bg-color:#000000de;--md-accent-bg-color--light:#0000008a}[data-md-color-accent=amber]{--md-accent-fg-color:#fa0;--md-accent-fg-color--transparent:#ffaa001a;--md-accent-bg-color:#000000de;--md-accent-bg-color--light:#0000008a}[data-md-color-accent=orange]{--md-accent-fg-color:#ff9100;--md-accent-fg-color--transparent:#ff91001a;--md-accent-bg-color:#000000de;--md-accent-bg-color--light:#0000008a}[data-md-color-accent=deep-orange]{--md-accent-fg-color:#ff6e42;--md-accent-fg-color--transparent:#ff6e421a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-primary=red]{--md-primary-fg-color:#ef5552;--md-primary-fg-color--light:#e57171;--md-primary-fg-color--dark:#e53734;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=pink]{--md-primary-fg-color:#e92063;--md-primary-fg-color--light:#ec417a;--md-primary-fg-color--dark:#c3185d;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=purple]{--md-primary-fg-color:#ab47bd;--md-primary-fg-color--light:#bb69c9;--md-primary-fg-color--dark:#8c24a8;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=deep-purple]{--md-primary-fg-color:#7e56c2;--md-primary-fg-color--light:#9574cd;--md-primary-fg-color--dark:#673ab6;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=indigo]{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=blue]{--md-primary-fg-color:#2094f3;--md-primary-fg-color--light:#42a5f5;--md-primary-fg-color--dark:#1975d2;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=light-blue]{--md-primary-fg-color:#02a6f2;--md-primary-fg-color--light:#28b5f6;--md-primary-fg-color--dark:#0287cf;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=cyan]{--md-primary-fg-color:#00bdd6;--md-primary-fg-color--light:#25c5da;--md-primary-fg-color--dark:#0097a8;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=teal]{--md-primary-fg-color:#009485;--md-primary-fg-color--light:#26a699;--md-primary-fg-color--dark:#007a6c;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=green]{--md-primary-fg-color:#4cae4f;--md-primary-fg-color--light:#68bb6c;--md-primary-fg-color--dark:#398e3d;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=light-green]{--md-primary-fg-color:#8bc34b;--md-primary-fg-color--light:#9ccc66;--md-primary-fg-color--dark:#689f38;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=lime]{--md-primary-fg-color:#cbdc38;--md-primary-fg-color--light:#d3e156;--md-primary-fg-color--dark:#b0b52c;--md-primary-bg-color:#000000de;--md-primary-bg-color--light:#0000008a}[data-md-color-primary=yellow]{--md-primary-fg-color:#ffec3d;--md-primary-fg-color--light:#ffee57;--md-primary-fg-color--dark:#fbc02d;--md-primary-bg-color:#000000de;--md-primary-bg-color--light:#0000008a}[data-md-color-primary=amber]{--md-primary-fg-color:#ffc105;--md-primary-fg-color--light:#ffc929;--md-primary-fg-color--dark:#ffa200;--md-primary-bg-color:#000000de;--md-primary-bg-color--light:#0000008a}[data-md-color-primary=orange]{--md-primary-fg-color:#ffa724;--md-primary-fg-color--light:#ffa724;--md-primary-fg-color--dark:#fa8900;--md-primary-bg-color:#000000de;--md-primary-bg-color--light:#0000008a}[data-md-color-primary=deep-orange]{--md-primary-fg-color:#ff6e42;--md-primary-fg-color--light:#ff8a66;--md-primary-fg-color--dark:#f4511f;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=brown]{--md-primary-fg-color:#795649;--md-primary-fg-color--light:#8d6e62;--md-primary-fg-color--dark:#5d4037;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=grey]{--md-primary-fg-color:#757575;--md-primary-fg-color--light:#9e9e9e;--md-primary-fg-color--dark:#616161;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-typeset-a-color:#4051b5}[data-md-color-primary=blue-grey]{--md-primary-fg-color:#546d78;--md-primary-fg-color--light:#607c8a;--md-primary-fg-color--dark:#455a63;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-typeset-a-color:#4051b5}[data-md-color-primary=light-green]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#72ad2e}[data-md-color-primary=lime]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#8b990a}[data-md-color-primary=yellow]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#b8a500}[data-md-color-primary=amber]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#d19d00}[data-md-color-primary=orange]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#e68a00}[data-md-color-primary=white]{--md-primary-fg-color:hsla(var(--md-hue),0%,100%,1);--md-primary-fg-color--light:hsla(var(--md-hue),0%,100%,0.7);--md-primary-fg-color--dark:hsla(var(--md-hue),0%,0%,0.07);--md-primary-bg-color:hsla(var(--md-hue),0%,0%,0.87);--md-primary-bg-color--light:hsla(var(--md-hue),0%,0%,0.54);--md-typeset-a-color:#4051b5}[data-md-color-primary=white] .md-button{color:var(--md-typeset-a-color)}[data-md-color-primary=white] .md-button--primary{background-color:var(--md-typeset-a-color);border-color:var(--md-typeset-a-color);color:hsla(var(--md-hue),0%,100%,1)}@media screen and (min-width:60em){[data-md-color-primary=white] .md-search__form{background-color:hsla(var(--md-hue),0%,0%,.07)}[data-md-color-primary=white] .md-search__form:hover{background-color:hsla(var(--md-hue),0%,0%,.32)}[data-md-color-primary=white] .md-search__input+.md-search__icon{color:hsla(var(--md-hue),0%,0%,.87)}}@media screen and (min-width:76.25em){[data-md-color-primary=white] .md-tabs{border-bottom:.05rem solid #00000012}}[data-md-color-primary=black]{--md-primary-fg-color:hsla(var(--md-hue),15%,9%,1);--md-primary-fg-color--light:hsla(var(--md-hue),15%,9%,0.54);--md-primary-fg-color--dark:hsla(var(--md-hue),15%,9%,1);--md-primary-bg-color:hsla(var(--md-hue),15%,100%,1);--md-primary-bg-color--light:hsla(var(--md-hue),15%,100%,0.7);--md-typeset-a-color:#4051b5}[data-md-color-primary=black] .md-button{color:var(--md-typeset-a-color)}[data-md-color-primary=black] .md-button--primary{background-color:var(--md-typeset-a-color);border-color:var(--md-typeset-a-color);color:hsla(var(--md-hue),0%,100%,1)}[data-md-color-primary=black] .md-header{background-color:hsla(var(--md-hue),15%,9%,1)}@media screen and (max-width:59.984375em){[data-md-color-primary=black] .md-nav__source{background-color:hsla(var(--md-hue),15%,11%,.87)}}@media screen and (max-width:76.234375em){html [data-md-color-primary=black] .md-nav--primary .md-nav__title[for=__drawer]{background-color:hsla(var(--md-hue),15%,9%,1)}}@media screen and (min-width:76.25em){[data-md-color-primary=black] .md-tabs{background-color:hsla(var(--md-hue),15%,9%,1)}} \ No newline at end of file diff --git a/diagrams/foreign_keys.drawio.png b/diagrams/foreign_keys.drawio.png new file mode 100644 index 0000000000000000000000000000000000000000..85852135c0165c9c5f73ef069bce3f020213b66c GIT binary patch literal 8392 zcmZ`i$f3*YrI7^mNbsn3`}k71@{AIrW^T!1JuZ`-eAqzpN7^mF->y4tOq$U0I^wfixY}zbXNJDu#AD#Vv`Pc1f zXY~8r?#=jUl5637y-uT+T2N3BHa0dT6?I2P2LS=m%NICeV&b$Q`gdHsWUt5}GK$2c zL{sZ$AXGtBvreSMGZ&#m?>?lNXb|o|_WqjrM&!0b`es*sd>B7SzU{F_|&(XYm!o|oQUmNrC z*yhWbl!cMi&f>8E7xVtM?y9uB^47e(yvD-#kJ<{Am6f0L zH8@#b&um^qC*_%FTP-gyL%nR|#FWQ6<}P+R+lN*VY2h*ca9tId=H_NSBTE|>KSe2# zAs-JjYnRfxJ_84JWZU@7=D^{w&)HJfuikDoRgJi`;%@;i_E3}gZp7pE$Z&m*s1SE* zXn~HlPGM|y;ZQ;r^m73mT31)+;1-yXk&%#rh>eWD|1q@MUwOD(aC&-L*Et1`@Ub>< zzPPwpjEh;x&uy%XceV5AtIhE9^9xRQt(ZwWJUqO;y*-#|Y3iGg@o-1vR&5T~-256D zYsxQ8tp7FNR=b=XmhZhe;B9DbZ(?Fvnc6ZvJ-sv0sH$ba!oxUMU0IjaH8?ovWgYa< zz_5NTFS|RYrGF9nC1jv>a<8hKksZ|6*LV4|qA{meTtM8#+2vp^E*YAW6C1QS;MbO( z_Qf?S#L?liZ%AQvCmastbz4;17Ji^~Yf@oa8xo~?F5)P(|4 zoO_xE*Qd8?65?&l?QL!C;EiG1?XCK%#)o5p2lL6Mp1O&(AsbB%n{zcIBO@JUDdXeg z2?+@gTf?o$uKw1{#j)}Rc+%1I)S$bIZ=%E2^4|UNP=uIpUVmIX@=HQ+=2CKEc9?jM z8%lypNT2r8#na>yqM&CJWsLfj5ef>Gg}ju6me=yH3=NUAn0j+BIca~0(XZ9=srCmtXO|aD zLO3)mviV9x*k+Qwg*S%3_3u%teyeFXPOqS`V!vPU4YVyk>1cN>e*j8sI`LEDhW32_ zpW=7M=C$Ry3M|O&`B2Kn&34Ul-^;8dXa0i`HVXd@gFIWz7{TJ;||D24PUE${jQXQ&~_P_cCcKOqNNReD>ID`%OL+pX0`F!c-n4QK{%dR01TK zVd%66)$nw=-M|bQmFY$INc@Hbf6kh6zSk$93_&$n69=%qCU0d)IQKzDeeGe(v1Oq5 zAfnUG^9^zVq0}jwRxl)VNQfOENj-66{KL2$ zsCu@|wt+Ct38p5Z#vsfX66-en(RYq|vOv%<-r+E5Mr6ANd*dYF#&&%V*9aquR^eb( zvRu&o2AS*uc5CbOzGBh=^+Z{AzZoHPAkXs9oV3pZ(lB>^HCTL-^d)A6&=GJcbB9;J zSb{@2MGnb=ovq-B2ebS1qS)Dq?q~#%raGx0B*nXloPCvk_%Vf03BVQ6$46tQ8O=U(AR*??tQ0V$X zl4^BR5wK7xX8`4-8I`A}_CwtI_>OMY39qe|60=mQ%smcqqXr&}c}u)LHVXLE?> z&xi}bTCWNQiY3adV_FFhlO4mg!oblgd`vbzxRtXDL`d%_q6%PYJ$3h_ByrW-Jr8kI zY%(hH@!X-B%bZ|;vpHT`|-_i0RU%AQ8ykrzl)&rP5Yieoi$_`1SV5FHl61eDZtoZe} ziNMj+x^PHR!yEJ8ub4i9xOc(Gli?+g6XSb~kg8S}D@Ur!zz=Cw&-O(iJ8E9GY@6dz z+^-@$BOSA%i*VkKc~0&vQsyaLpYF7+UAc91{;wnbzYqBTXL*cQ7HMi+9sRxAX0$g7 z0`2YJp=54Cj(%ttcsxE5^7sMuDN5&e z{v{ESPOe_~cPXZWl2Y-OiRq92PNj~rJASYIJNI(o4;=yfwhyFwm(@>lp9*BCnOS1C zwxzAMF51ivI)=kBnULv-F^>~F=YOI-rb;h zdw4d$&zLNgu)h(sdS|@)3Ra?exIK^gGwuVyP`m+66umbAX0{!{UnVVdz$Gw}n*KoXY!IQHwCxE!5*H489KPWBfz6wKA{pnECKMs=N^9LDuiy!?Db2Lv*0t~u_>}8uyM7?hm_Yt^hAkIiIeugn*Z$fc zd+FB(I=^S8RQ|bRA=`aGE$ET`zH#`Q3OYmV-BEp2s!tyA0OW-JNcp{oQ23U8L&%&U zMV+7pjqTm(T?b?A6Q^|YkI`=sr;SQv5v=CTiZ?;*V8>%H^Q<(*kBmVbcYV>5#&N;P zdIVE%NbwA2MBPGqOg*3AVl{#Z{BnvJOoNq5`X#1;Z&{2nU9?ctnvGegWW1hQSJj|p zZmduGlV#S85>A!mxk1jB1l|?W4y+$B zDbY|*p65YmA)=+nk3D($OVi2`rP?f%q}pk$*L2}-AM}xz^J_Lv2czQ+P4z{Nc4W)4 z^=kPW5t7bd*cSAPj@-eYSgq5_+ISbp6xibLQf>9mD34ZN_&dkf<2ol5)f*nIH1oIB zn8X*@$(#QgOn1H-5W1yr?u{L0|M{W)jC9P*?9KE^F9@{JD14r0!OO$cq#B>-IsoTY zDEXvua+{AoG1Yn_odqiph-zHOimFK+?s2}0{o_8uCJ)~3)$YXpP`#Po{H%b~*gf}n zSEjKP@dcAT;hDT~AbTB^1!?-ke!O<=%H1qT`kYSj!cov`Aq(Z5+Lb3-g!F_OXLM@w z9$}``tW&I?O1<2R7t(iHFbHAnGi)T|A35ix@o3;w0ZUe&SKBy|zu zl-SlmAL-29_0J;_uPrBi39Y<77nw?3_kWj1qpD{EF`@a`v%|1kn=n=g707-FENe9e z>8fUT^p%!rUj>eRS3zA1X~i-_=~rbX7z?;Mt^yo_2Ab-85ftc z;D+vB>KB}6_zwn$W-P|)B}7bGdwwMQI+JIFO;!5Mvm+v-rM_JVc8bi|!@>UVvSFKE z%uBMZB#kwrFZ;hSisPNGN>O#K(kDWHc}ReWi`6`PuF}`)$kAoSE>`3ek~XH4Zm4~Vg`|=sxn!~TnSe-}^l_+pa?a-R3enHf z88kY_h8T7JIyiKfehib8%r7Xzp1QQwZ!xUxzIm3Zm(8KwkuyveQrn(>n3@(T89>_1 zU3tcj6CXp<&`vawLSKHNY*GD}!E`94a=@Ys0&-Qt27XSL4`bn$rTEq5E{Ct8Ze@|6 z0o8X>vG4aj^Hdzy;8hR(RZnt9a6KRz*NMrqb}P_=AY9wh(376Tvt)9aJHW#jW+|BB zkOH3_1Sx3Ap=xWeC#~L@XqUk94=mQ*0%|y)1ljfs4MJg%LC-lp+G(!lkg#5VAGQ04 z^2%gNR&A?zH&vU9rUW!z=H7z2_6+lA+K@krE0KkK-0RK_kX>OqHt0MkAI5l9@=BGS ztp^7`yltbhX=HxEzvS=gI5+B;cARxU$e*;f8XRl-k3Vm4`Jd#+c?k)BOGNcrO>OGd z?v)Zpnbt|GQz*^Ju_Q(~NF!vK3(B+GoZ4Ir7QCkD*&;%Y6R8v24VW);y&_2MlS#0T zsoy&`v+h;%S>~j>x@V>+<(|D0NdYGvxyDv{5B$lvecJKQ^ro3om?xQwKOrTKar&A5 zjawx4%3GdQ&K-b%o_NZROEEq8F$5sMNfZ6ylYAgP^H5OYLr-+LeiSw|KPNs9aY+J7 zCo#*={W>r;<~-d90BS%b9Ei>wLmbDXX%@mtCBPnqcrn<+jnx~wX}}F)Du|1j>3LNx z6L6aCuHCh<68lWC%AV2G3aI#2(mjm;!~l=Eed!%cpC0R6;n52Sfw-GdKY_unUy!=q)oTQTVQk)cOrB;!(n}+y)64>#hMl}D+UA|2@|C4^>oI5XOs%< zs|<%Fch0`3%1_BN=lDcIxq6VqS55@Q%d(7XLRXU}*@7LE23@_ec(z_Ns8W z@&{5Z`J!_^j&nT{fmQ=>K3?&p&BmPthQyefe>CkoF&Tbj^jk+;7)x2`)=W#`T_9#u z6gemX<6{Bg`0t|*0*sTP&30P-<*9P5_IdG-Uv%S6R?;Ngn;f$ckT`_aGK@~^;KW_^Ar~}Sc zdyl6FzHE+0!}{JYWPtuVDlF!MZ3i4#JJoV_fuzDUBm$R)n*P`Uh4vKm|rcK-pg> zFG))9%Li}w%OG_8sbCiwet>|_U3*lxIW!X13IC%WrR&mQ5%O0@Kc9PTDxBEDbNCLF zg@xrQ1%*|Ghyy5W{xD&gY(>5Sy1?`Elm|@?VqSsj3I_?00j@^Z8-IwfoGC>hlv&)M zZ*su%Q#+s)J%J-f9UUc!F~xl-p~ z+CGv^gZ0eH2Eh&wXaP+Ae&ztOqbPomCL9m}TzmF&f6a9S)Aa(dB-@tHEetI-l_V(F zxWy7sYWoFEpR*p%;x{v2dWU7V?;X8;*I)y#T3~Cf4rXig-Eg`tQ%N2}3h221ecVVl zBReH#vA7wC6Ybw1L}mhx^xTnJZuY?6+%b59#g_WN#B{e~u6C z#a@Gc(qCJ7msa}Jc`+);lO$ka!=T;P$=NXbl?T(T;k>3z#cFj%rEp<*#=<&*JM{f) zIC|u#BYHsWh}l3wen4vb(|lP<0A^3^gjxPs~yEPkLv>(M+-6-e~l9Ub|5y1(wQVjc*U@^-~P) zs9%p>&4%EW;OuBEghF&Hy9Bn~Qh4qJUWRl*9a}g$lu!?=X_79NxWf zARRUEj*#duPRs%l!^kOeeeTF|A3NUQYI5*_NO6XaL?Pn_?`$T(>PhbE6UgLK&iG7j z(nS(@RFM_=R0^!79JeVj`BU_F#{4(Zd%R@jEJnMf1Onq06g_ViwAa1J9}L{(#AF)Z zO7V`k1hE_8yn8pp+48oh(c7ZW)N*IE%@sGMZ@=)}t{x$hwMcPs^b}|MjTmS~@T(qf z98f@HXAHTM?Hr5E_wI{f$AHgU>F}&kC}4wvYyH_~Zh&KwJItpEOP-(O<|FMEGSz-k z@+0jm2+RBtTx-5=skiot7wxs%XVG=2;tJqpU(A%ZN>Wg*TDP)D45-)R$=7zVuv zG6E52qQqd8ikPHG0?#E>*F{4q^9>y!D(998X5$r?-$vmhf9pQ})0jF`vu8HkGKVSl?G->sG%BoYMEu@BHw2V>k-&qWQwROy-hf#otb);Mq|(Vzt@M0gfuW&w2txZ?Jvr0`y%6?XRhcEq&l zBTZI`0JU3qeOs+*{r1AbsglbyT`>d^o#oIRS%WW(K|akmo6^87XU2r>AUt>{mH*W`Z$Ka zy*~5TbMdy*T?k)dvHm{uYh=0LanO?;8!Px2Cs$HB0je;(JKi^u5jl1IAz>r9n;YrA zjUAnkx8(ch(+i4Y01JrAHkuQ}g@_s62rc%|O?-OIBwKU+J^-SWg>|cme=cpe+P>uE zl;7J&EiO0f8*>c?ztO&zLQ|1SfvL^PHoB@?Tt3;J{4&iI?B-PZ_RCYsEw;SE4PTeG z)Qt4HxWQdur?uM|gWi}BGBmdXyZMgUWnc39#y zf0<86DferTR%sFhkm-uA*VaESZGIU^pz$%)mbI03M3zf=M}A_y45BDeQZt()XqD1| zH6e@rUUQxq%6Up1YEWsM2mqOsHdmiDI{$vTHm=`&{4FXWBWmlQUhNsx~!)c#QE= z1{W=B>%jK~miGmVdsW(9UuQ3unhEdSnh6KuOlH2@EqW5*l1dH_**cwxQjP?|%Ml@= zCI1ayM7w3#)JdDw%(;Z*SwPJ@ckh;7!k?2s+*;efhyv+H0PWXa@|PM2A_}T{X1RI) z96W6%?PL`}-dU3P7~K6CPjbBd@vevE8%e>!e>R0&h%|PNLnTZzi6dy$1?2?>WKgdO zteK?fs*P#ii&W7_IJ==(@r}|b=*UgZR!GJRX8y>aEm$PfDqpnX)e4_gxL*2Z7Cg~j zesxH80=oI1m~X|ymZl+%POwBtkd*tROazdt^f0J3^@ndvvQ}lnCOJVpbDjo+#=y&b z1yV^UQ9O-*$%r0U;gDPqX)H0Dgn5tIr$$c`og z*+TffF0TJ9m}OybOCqjkE>I97?}Ceb0iNRxMR*d^ifZfn+JBodRQe}=^gl2qCz8T! z+AhDhE}{$#gz!=#8`pmlE0!!Q?_YzyBd{+>X;S_76De=}R=9RL@FZOS_QJv+6)Noq zq$-2-6}9ZJJD0)S`S~ZdvP{o~q3#1Q5eU>({Ra7nR}uf|IDm9$K1&5zM+>HefQS2E zgK7_M!B8C$G|24io?s?c3dfQUQU%z}1M*s52N2|1{2;fZB;?X{IEf0FaL43;wgyHj z05ThrbwsjC@@o&!L9W*glCL?S-2EVe&-+IO+7p({Oyxe@kgsgxXc@><@^Y{grbZq@ zKCorg!NURknhuE`E04|b*vC###8~iF0ZCbci$x@=!lSjs4aCa18U0hWe`|XkF$FgoV$s7 zTf-0bvYmOt^bmkF(p~Mo%f{708#Tde$Me_>-(~3_Lr{dVsp|;+a0SyjPWPlOZPVd1 zbqSVDMQ0w%$B*=c^U3^BV_#qEx!)-Y3JB^**cCz3lAXF{-W=2_(8jHxI%0HO#Wkm# zc_QaOW7JJ^WR(;*;!-0=^gEkkqz7*Zt^LXrT|DLE=Gc@aJUa~HTCsANqvdoj-nX#& zIdYWyh-%7P&*hbanlL!^XJ@T=K+9Q{R=9pf^(r`Ur1>@(KIBbYd18RT2v#8q2#5cA zY981?O(2&@tr)i-enIhJo=;(#_*B_o0Tv6Vam{yIU=wkK9Z+j{<;*hUOKX^cs(=(E)n@qDu%rxQb&I0qB&BCF-y5Rhf`*(h9Oi-4!JP5f&bwJw94%pI=?yuoPsy@;Fze>MjOyn(;rm3RtUPls ziAuI7POYh%^)=|C2{yM9$^ATkkR5=9cxkOL2%`mmh9(rvX=f%*Yz?s`QbWn$I^Tq; z{SJP=d`!7yZr*}iAj))hpfB!V1GPDi>jgBX?YB%jp^DdVLXC}}vUa|+rLiKGj)#El znY0NwVca6crC$gdw)qIV_eIB3pr&iBkZkP07ghiEMIC+``=Mx2JlPb&>8S|i!2{n@ z#ZevCQJPa?SIBy6Kco4aLt~xGLnVu2m%|QpaYI^qP35O|d>=w|WAl8?{FXF!yJhH{ zgHGQ8Imo-i`{RX_5yWe5*Efd@w5JFFZGEwTW^;g`Fp*UJA4ZTrLjJW_@UI=v(^AzM zX>+HrF1Ss7*lf$I;srZ=`C7z)w6!o=H=-Ta9!U1fn5(ejZW~8VD?vnEQ+%?JmR{Uz zt_X`R3S|m_FB4=19h4OxBxFbJ((*;X$j&${~x-=M&4KYdG~xj-@BKzB()4likV z*Fh}5IwSOeL#^B#pG5e`Iyxk8&;FZLDQw$98jU(^H
+ +
Data Source A
Data Source A
Data Source B
Data Source B
Data Caterer
Data Caterer
Data Storage C
Data Storage C
Data Caterer
Data Caterer
1. Generate
1. Generate
Data Consumer
Data Consumer
2. Consume
2. Consume
Data Source D
Data Source D
4. Validate
4. Validate
3. Write
3. WriteText is not SVG - cannot display \ No newline at end of file diff --git a/diagrams/high_level_flow-high-level-dark.svg b/diagrams/high_level_flow-high-level-dark.svg new file mode 100644 index 00000000..e79ffcc9 --- /dev/null +++ b/diagrams/high_level_flow-high-level-dark.svg @@ -0,0 +1,3 @@ + + +
Data Caterer
Data Caterer
No-SQL
No-SQL
JDBC
JDBC
Messaging
Messaging
HTTP
HTTP
Metadata
Metadata
Files
Files
Jobs
Jobs

  • Read metadata from data sources
    • Direct connection
    • Sample data
    • Metadata services
  • Generate data for consumers
    • Data format agnostic
  • Run data validations
    • Basic
    • Aggregate
    • Relationship
    • Data profile
  • Clean up generated data

Read metadata from data sources...
Cloud
Cloud
Kubernetes
Kuber...Text is not SVG - cannot display \ No newline at end of file diff --git a/diagrams/high_level_flow-high-level.svg b/diagrams/high_level_flow-high-level.svg new file mode 100644 index 00000000..30ca6499 --- /dev/null +++ b/diagrams/high_level_flow-high-level.svg @@ -0,0 +1,3 @@ + + +
Data Caterer
Data Caterer
No-SQL
No-SQL
JDBC
JDBC
Messaging
Messaging
HTTP
HTTP
Metadata
Metadata
Files
Files
Jobs
Jobs

  • Read metadata from data sources
    • Direct connection
    • Sample data
    • Metadata services
  • Generate data for consumers
    • Data format agnostic
  • Run data validations
    • Basic
    • Aggregate
    • Relationship
    • Data profile
  • Clean up generated data

Read metadata from data sources...
Cloud
Cloud
Kubernetes
Kuber...Text is not SVG - cannot display \ No newline at end of file diff --git a/diagrams/high_level_flow-run-config-basic-flow.drawio.svg b/diagrams/high_level_flow-run-config-basic-flow.drawio.svg new file mode 100644 index 00000000..cabe725b --- /dev/null +++ b/diagrams/high_level_flow-run-config-basic-flow.drawio.svg @@ -0,0 +1,4 @@ + + + +
Data Source A
Data Source A
Data Source B
Data Source B
Data Caterer
Data Caterer
Data Storage C
Data Storage C
Data Caterer
Data Caterer
1. Generate
1. Generate
Data Consumer
Data Consumer
2. Consume
2. Consume
Data Source D
Data Source D
4. Validate
4. Validate
3. Write
3. WriteText is not SVG - cannot display \ No newline at end of file diff --git a/diagrams/high_level_flow-run-config.svg b/diagrams/high_level_flow-run-config.svg new file mode 100644 index 00000000..cfc5a43f --- /dev/null +++ b/diagrams/high_level_flow-run-config.svg @@ -0,0 +1,3 @@ + + +
Data Source A
Data Source A
Data Storage A
Data Storage A
Data Source B
Data Source B
Consumer A
Consumer A
Consumer B
Consumer B
Data Caterer
Data Caterer
1a. Generate
1a. Generate
4. Validate
4. Validate
1b. Generate
1b. Generate
2a. Read
2a. Read
3a. Write
3a. Write
3b. Write
3b. Write
2b. Read
2b. Read
Data Source A
Data Source A
Data Storage A
Data Storage A
Consumer A
Consumer A
Data Caterer
Data Caterer
1. Generate
1. Generate
4. Validate
4. Validate
2. Read
2. Read
3. Write
3. Write
Generate and Validate
Generate and Validate
Generate Multiple and Validate
Generate Multiple and Validate
Data Source A
Data Source A
Data Storage A
Data Storage A
Consumer A
Consumer A
Data Caterer
Data Caterer
2. Generate
2. Generate
5. Validate
5. Validate
3. Read
3. Read
4. Write
4. Write
External Metadata, Generate and Validate
External Metadata, Generate and Validate
Metadata Source
Metadata Source
1. Get Schema/Metadata
1. Get Schema/Metadata
Data Source A
Data Source A
Data Storage A
Data Storage A
Consumer A
Consumer A
Data Caterer
Data Caterer
2. Generate
2. Generate
5. Validate
5. Validate
3. Read
3. Read
4. Write
4. Write
Direct Metadata, Generate and Validate
Direct Metadata, Generate and Validate
1. Get Schema/Metadata
1. Get Schema/Metadata
Data Source A
Data Source A
Data Storage A
Data Storage A
Consumer A
Consumer A
Data Caterer
Data Caterer
3. Generate
3. Generate
6. Validate
6. Validate
4. Read
4. Read
5. Write
5. Write
Direct Metadata for Schema/Validations, Generate and Validate
Direct Metadata for Schema/Validations, Generate and Validate
1. Get Schema/Metadata
1. Get Schema/Metadata
2. Generate Validations
2. Generate Validations
Data Source A
Data Source A
Data Storage A
Data Storage A
Consumer A
Consumer A
Data Caterer
Data Caterer
3. Generate
3. Generate
6. Validate
6. Validate
4. Read
4. Read
5. Write
5. Write
External Metadata for Schema/Validations, Generate and Validate
External Metadata for Schema/Validations, Generate and Validate
1. Get Schema/Metadata
1. Get Schema/Metadata
2. Get Validations
2. Get Validations
Metadata Source
Metadata Source
Data Quality Source
Data Quality Source
Data Source A
Data Source A
Data Storage A
Data Storage A
Consumer A
Consumer A
Data Caterer
Data Caterer
1. Generate
1. Generate
4. Validate
4. Validate
2. Read
2. Read
3. Write
3. Write
Generate, Validate and Clean
Generate, Validate and Clean
5. Clean
5. Clean
Data Source A
Data Source A
Data Source B
Data Source B
Data Caterer
Data Caterer
1. Generate
1. Generate
2. Generate
2. Generate
Generate data
Generate data
Data Storage A
Data Storage A
Data Storage B
Data Storage B
Data Caterer
Data Caterer
2. Validate
2. Validate
Validate data
Validate data
1. Validate
1. ValidateText is not SVG - cannot display \ No newline at end of file diff --git a/diagrams/logo/data_catering_landscape_banner.svg b/diagrams/logo/data_catering_landscape_banner.svg new file mode 100644 index 00000000..2fba3f61 --- /dev/null +++ b/diagrams/logo/data_catering_landscape_banner.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/diagrams/logo/data_catering_logo.svg b/diagrams/logo/data_catering_logo.svg new file mode 100644 index 00000000..42c2c8f4 --- /dev/null +++ b/diagrams/logo/data_catering_logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/diagrams/logo/data_catering_transparent.svg b/diagrams/logo/data_catering_transparent.svg new file mode 100644 index 00000000..cc6a8d60 --- /dev/null +++ b/diagrams/logo/data_catering_transparent.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/diagrams/logo/data_catering_with_title.svg b/diagrams/logo/data_catering_with_title.svg new file mode 100644 index 00000000..40361c0f --- /dev/null +++ b/diagrams/logo/data_catering_with_title.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/diagrams/logo/data_catering_with_title_medium.svg b/diagrams/logo/data_catering_with_title_medium.svg new file mode 100644 index 00000000..ecb259e6 --- /dev/null +++ b/diagrams/logo/data_catering_with_title_medium.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/diagrams/marquez_dashboard.png b/diagrams/marquez_dashboard.png new file mode 100644 index 0000000000000000000000000000000000000000..3332b19ace55d4b2c216f8a4c0779de370411bba GIT binary patch literal 77578 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

I$4nW%)jltRT=8n`l> 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 P!=)&vDqAXT`uYC=V!5u} literal 0 HcmV?d00001 diff --git a/diagrams/openmetadata_dashboard.png b/diagrams/openmetadata_dashboard.png new file mode 100644 index 0000000000000000000000000000000000000000..55ad079061fb3b4e8a181170746bd33f1883c368 GIT binary patch literal 97994 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 literal 0 HcmV?d00001 diff --git a/diagrams/solace_dashboard.png b/diagrams/solace_dashboard.png new file mode 100644 index 0000000000000000000000000000000000000000..467b00e23ee4c5e1ffc870d944fe1894751c4546 GIT binary patch literal 19782 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 C$;ZS1 literal 0 HcmV?d00001 diff --git a/diagrams/solace_messages_queued.png b/diagrams/solace_messages_queued.png new file mode 100644 index 0000000000000000000000000000000000000000..7c586384550309021bba7fa889a47b3b4c1df930 GIT binary patch literal 96532 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 literal 0 HcmV?d00001 diff --git a/diagrams/use_case_replicate_production.drawio.svg b/diagrams/use_case_replicate_production.drawio.svg new file mode 100644 index 00000000..e8236770 --- /dev/null +++ b/diagrams/use_case_replicate_production.drawio.svg @@ -0,0 +1,4 @@ + + + +
Data Caterer
Data Caterer
Database
Database
Files
Files
Events
Events
API
API
Database
Database
Files
Files
Event
Schema
Event...
API
Definition
API...
Get Latest Schema
Get Latest Schema
Generate Data
Generate Data
Jobs
Jobs
Services
Services
Other Data Consumers
Other Data Consumers
Consume Data
Consume Data
Data Caterer
Data Caterer
Database
Database
Files
Files
Events
Events
API
API
Validate/Clean Data
Validate/Clean Data
Metadata
Services
Metadata...Text is not SVG - cannot display \ No newline at end of file diff --git a/diagrams/use_case_replicate_production.svg b/diagrams/use_case_replicate_production.svg new file mode 100644 index 00000000..38620369 --- /dev/null +++ b/diagrams/use_case_replicate_production.svg @@ -0,0 +1,3 @@ + + +
Data Caterer
Data Caterer
Database
Database
Files
Files
Events
Events
API
API
Database
Database
Files
Files
Event
Schema
Event...
API
Definition
API...
Get Latest Schema
Get Latest Schema
Generate Data
Generate Data
Jobs
Jobs
Services
Services
Other Data Consumers
Other Data Consumers
Consume Data
Consume Data
Data Caterer
Data Caterer
Database
Database
Files
Files
Events
Events
API
API
Validate/Clean Data
Validate/Clean Data
Metadata
Services
Metadata...Text is not SVG - cannot display \ No newline at end of file diff --git a/get-started/docker/index.html b/get-started/docker/index.html new file mode 100644 index 00000000..d6cbb796 --- /dev/null +++ b/get-started/docker/index.html @@ -0,0 +1,2104 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Get Started - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Run Data Caterer

+

Quick start

+

Ensure you have docker installed and running.

+
git clone git@github.com:pflooky/data-caterer-example.git
+cd data-caterer-example && ./run.sh
+#check results under docker/sample/report/index.html folder
+
+

Report

+

Check the report generated under docker/data/custom/report/index.html.

+

Sample report can also be seen here

+ +

30 day trial of the paid version can be accessed via these steps:

+
    +
  1. Join the Slack Data Catering Slack group here
    2. +
  2. Get an API_KEY by using slash command /token in the Slack group (will only be visible to you)
    3. +
  3. +
    git clone git@github.com:pflooky/data-caterer-example.git
+cd data-caterer-example && export DATA_CATERING_API_KEY=<insert api key>
+./run.sh
+
    +
    4. +
+

If you want to check how long your trial has left, you can check back in the Slack group or type /token again.

+

Guided tour

+

Check out the starter guide here that will take your through +step by step. You can also check the other guides here to see the other possibilities of +what Data Caterer can achieve for you.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/index.html b/index.html new file mode 100644 index 00000000..9c61590b --- /dev/null +++ b/index.html @@ -0,0 +1,2196 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Data Caterer is a metadata-driven data generation and +testing tool that aids in creating production-like data across both batch and event data systems. Run data validations +to ensure your systems have ingested it as expected, then clean up the data afterwards.

+ +

Simplify your data testing

+ +

Take away the pain and complexity of your data landscape and let Data Caterer handle it

+ +

+Try now +

+

Data testing is difficult and fragmented

+ +
    +
  • Data being sent via messages, HTTP requests or files and getting stored in databases, file systems, etc.
    • +
  • Maintaining and updating tests with the latest schemas and business definitions
    • +
  • Different testing tools for services, jobs or data sources
    • +
  • Complex relationships between datasets and fields
    • +
  • Different scenarios, permutations, combinations and edge cases to cover
    • +
+

Current solutions only cover half the story

+ +
    +
  • Specific testing frameworks that support one or limited number of data sources or transport protocols
    • +
  • Under utilizing metadata from data catalogs or metadata discovery services
    • +
  • Testing teams having difficulties understanding when failures occur
    • +
  • Integration tests relying on external teams/services
    • +
  • Manually generating data, or worse, copying/masking production data into lower environments
    • +
  • Observability pushes towards being reactive rather than proactive
    • +
+

+Try now +

+

What you need is a reliable tool that can handle changes to your data landscape

+ +
+

High level overview of Data Caterer + High level overview of Data Caterer

+
+

With Data Caterer, you get:

+
    +
  • Ability to connect to any type of data source: files, SQL or no-SQL databases, messaging systems, HTTP
    • +
  • Discover metadata from your existing infrastructure and services
    • +
  • Gain confidence that bugs do not propagate to production
    • +
  • Be proactive in ensuring changes do not affect other data producers or consumers
    • +
  • Configurability to run the way you want
    • +
+

+Try now +

+

Tech Summary

+

Use the Java, Scala API, or YAML files to help with setup or customisation that are all run via a Docker image. Want to +get into details? Checkout the setup pages here to get code examples and guides that will take you +through scenarios and data sources.

+

Main features include:

+
    +
  • Metadata discovery
    • +
  • Batch and event data generation
    • +
  • Maintain referential integrity across any dataset
    • +
  • Create custom data generation scenarios
    • +
  • Clean up generated data
    • +
  • Validate data
    • +
  • Suggest data validations
    • +
+
+

Basic flow

+
+

Check other run configurations here.

+

What is it

+
+
    +
  • +

    Data generation and testing tool

    +
    +

    Generate production like data to be consumed and validated.

    +
    • +
  • +

    Designed for any data source

    +
    +

    We aim to support pushing data to any data source, in any format.

    +
    • +
  • +

    Low/no code solution

    +
    +

    Can use the tool via either Scala, Java or YAML. Connect to data or metadata sources to generate data and validate.

    +
    • +
  • +

    Developer productivity tool

    +
    +

    If you are a new developer or seasoned veteran, cut down on your feedback loop when developing with data.

    +
    • +
+
+

What it is not

+
+
    +
  • +

    Metadata storage/platform

    +
    +

    You could store and use metadata within the data generation/validation tasks but is not the recommended approach. +Rather, this metadata should be gathered from existing services who handle metadata on behalf of Data Caterer.

    +
    • +
  • +

    Data contract

    +
    +

    The focus of Data Caterer is on the data generation and testing, which can include details about how the data looks +like and how it behaves. But it does not encompass all the additional metadata that comes with a data contract such +as SLAs, security, etc.

    +
    • +
  • +

    Metrics from load testing

    +
    +

    Although millions of records can be generated, there are limited capabilities in terms of metric capturing.

    +
    • +
+
+

+Try now +

+

Data Catering vs Other tools vs In-house

+ +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Data CateringOther toolsIn-house
Data flowBatch and events generation with validationBatch generation only or validation onlyDepends on architecture and design
Time to results1 day1+ month to integrate, deploy and onboard1+ month to build and deploy
SolutionConnect with your existing data ecosystem, automatic generation and validationManual UI data entry or via SDKDepends on engineer(s) building it
+

+ + + + + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/js/open_in_new_tab.js b/js/open_in_new_tab.js new file mode 100644 index 00000000..964fb4c1 --- /dev/null +++ b/js/open_in_new_tab.js @@ -0,0 +1,45 @@ +// Description: Open external links in a new tab and PDF links in a new tab +// Source: https://jekyllcodex.org/without-plugin/new-window-fix/ + +//open external links in a new window +function external_new_window() { + for(let c = document.getElementsByTagName("a"), a = 0;a < c.length;a++) { + let b = c[a]; + if(b.getAttribute("href") && b.hostname !== location.hostname) { + b.target = "_blank"; + b.rel = "noopener"; + } + } +} +//open PDF links in a new window +function pdf_new_window () +{ + if (!document.getElementsByTagName) { + return false; + } + let links = document.getElementsByTagName("a"); + for (let eleLink=0; eleLink < links.length; eleLink ++) { + if ((links[eleLink].href.indexOf('.pdf') !== -1)||(links[eleLink].href.indexOf('.doc') !== -1)||(links[eleLink].href.indexOf('.docx') !== -1)) { + links[eleLink].onclick = + function() { + window.open(this.href); + return false; + } + } + } +} + +function apply_rules() { + external_new_window(); + pdf_new_window(); +} + +if (typeof document$ !== "undefined") { + // compatibility with mkdocs-material's instant loading feature + // based on code from https://github.com/timvink/mkdocs-charts-plugin + // Copyright (c) 2021 Tim Vink - MIT License + // fixes [Issue #2](https://github.com/JakubAndrysek/mkdocs-open-in-new-tab/issues/2) + document$.subscribe(function() { + apply_rules(); + }) +} \ No newline at end of file diff --git a/legal/privacy-policy/index.html b/legal/privacy-policy/index.html new file mode 100644 index 00000000..a2363a30 --- /dev/null +++ b/legal/privacy-policy/index.html @@ -0,0 +1,2131 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Privacy policy - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Privacy Policy

+

Last updated September 25, 2023

+

Data Caterer Policy on Privacy of Customer Personal Information

+

Peter John Flook is committed to protecting the privacy and security of your personal information obtained by reason of +your use +of Data Caterer. This policy explains the types of customer personal information we collect, how it is used, and the +steps +we take to ensure your personal information is handled appropriately.

+

Who is Peter John Flook?

+

For purposes of this Privacy Policy, “Peter John Flook” means Peter John Flook, the company developing and providing +Data Caterer and related websites and services.

+

What is personal information?

+

Personal information is information that refers to an individual specifically and is recorded in any form. Personal +information includes such things as age, income, date of birth, ethnic origin and credit records. Information about +individuals contained in the following documents is not considered personal information:

+
    +
  • public telephone directories, where the subscriber can refuse to be listed
    • +
  • professional and business directories available to the public
    • +
  • public registries and court records
    • +
  • other publicly available printed and electronic publications
    • +
+

We are accountable to you

+

Peter John Flook is responsible for all personal information under its control. Our team is accountable for compliance +with these privacy and security principles.

+ +

Peter John Flook identifies the purpose for which your personal information is collected and will be used or disclosed. +If that purpose is not listed below we will do this before or at the time the information is actually being collected. +You will be deemed to consent to our use of your personal information for the purpose of:

+
    +
  • communicating with you generally
    • +
  • processing your purchases
    • +
  • processing and keeping track of transactions and reporting back to you
    • +
  • protecting against fraud or error
    • +
  • providing product and services requested by you
    • +
  • recommending products and services that Peter John Flook believes will be of interest and provide value to you
    • +
  • fulfilling any other purpose that would be reasonably apparent to the average person at the time we collect it from + you
    • +
+

Otherwise, Peter John Flook will obtain your express consent (by verbal, written or electronic agreement) to collect, +use or disclose your personal information. You can change your consent preferences at any time by contacting Peter John +Flook (please refer to the “How to contact us” section below).

+

We limit collection of your personal information

+

Peter John Flook collects only the information required to provide products and services to you. Peter John Flook will +collect personal information only by clear, fair and lawful means.

+

We receive and store any information you enter on our website or give us in any other way. You can choose not to provide +certain information, but then you might not be able to take advantage of many of our features.

+

Peter John Flook does not receive or store personal content saved to your local device while using Data Caterer.

+

We also receive and store certain types of information whenever you interact with us.

+

Information provided to Stripe

+

All purchases that are made through this site are processed securely and externally by Stripe. Unless you expressly +consent otherwise, we do not see or have access to any personal information that you may provide to Stripe, other than +information that is required in order to process your order and deliver your purchased items to you (eg, your name, +email address and billing/postal address).

+

We limit disclosure and retention of your personal information

+

Peter John Flook does not disclose personal information to any organization or person for any reason except the +following:

+

We employ other companies and individuals to perform functions on our behalf. Examples include fulfilling orders, +delivering packages, sending postal mail and e-mail, removing repetitive information from customer lists, analyzing +data, providing marketing assistance, processing credit card payments, and providing customer service. They have access +to personal information needed to perform their functions, but may not use it for other purposes. We may use service +providers located outside of Australia, and, if applicable, your personal information may be processed and stored in other +countries and therefore may be subject to disclosure under the laws of those countries. +As we continue to develop our business, we might sell or buy stores, subsidiaries, or business units. In such +transactions, customer information generally is one of the transferred business assets but remains subject to the +promises made in any pre-existing Privacy Notice (unless, of course, the customer consents otherwise). Also, in the +unlikely event that Peter John Flook or substantially all of its assets are acquired, customer information of course +will be one +of the transferred assets. +You are deemed to consent to disclosure of your personal information for those purposes. If your personal information is +shared with third parties, those third parties are bound by appropriate agreements with Peter John Flook to secure and +protect +the confidentiality of your personal information.

+

Peter John Flook retains your personal information only as long as it is required for our business relationship or as +required +by federal and provincial laws.

+

We keep your personal information up to date and accurate

+

Peter John Flook keeps your personal information up to date, accurate and relevant for its intended use.

+

You may request access to the personal information we have on record in order to review and amend the information, as +appropriate. In circumstances where your personal information has been provided by a third party, we will refer you to +that party (e.g. credit bureaus). To access your personal information, refer to the “How to contact us” section below.

+

The security of your personal information is a priority for Peter John Flook

+

We take steps to safeguard your personal information, regardless of the format in which it is held, including:

+

physical security measures such as restricted access facilities and locked filing cabinets +electronic security measures for computerized personal information such as password protection, database encryption and +personal identification numbers. We work to protect the security of your information during transmission by using +“Transport Layer Security” (TLS) protocol. +organizational processes such as limiting access to your personal information to a selected group of individuals +contractual obligations with third parties who need access to your personal information requiring them to protect and +secure your personal information +It’s important for you to protect against unauthorized access to your password and your computer. Be sure to sign off +when you’ve finished using any shared computer.

+ +

Our site may include third-party advertising and links to other websites. We do not provide any personally identifiable +customer information to these advertisers or third-party websites.

+

These third-party websites and advertisers, or Internet advertising companies working on their behalf, sometimes use +technology to send (or “serve”) the advertisements that appear on our website directly to your browser. They +automatically receive your IP address when this happens. They may also use cookies, JavaScript, web beacons (also known +as action tags or single-pixel gifs), and other technologies to measure the effectiveness of their ads and to +personalize advertising content. We do not have access to or control over cookies or other features that they may use, +and the information practices of these advertisers and third-party websites are not covered by this Privacy Notice. +Please contact them directly for more information about their privacy practices. In addition, the Network Advertising +Initiative offers useful information about Internet advertising companies (also called “ad networks” or “network +advertisers”), including information about how to opt-out of their information collection. You can access the Network +Advertising Initiative at http://www.networkadvertising.org.

+

Redirection to Stripe

+

In particular, when you submit an order to us, you may be automatically redirected to Stripe in order to complete the +required payment. The payment page that is provided by Stripe is not part of this site. As noted above, we are not privy +to any of the bank account, credit card or other personal information that you may provide to Stripe, other than +information that is required in order to process your order and deliver your purchased items to you (eg, your name, +email address and billing/postal address). We recommend that you refer to Stripe’s privacy statement if you would like +more information about how Stripe collects and handles your personal information.

+

We are open about our privacy and security policy

+

We are committed to providing you with understandable and easily available information about our policy and practices +related to management of your personal information. This policy and any related information is available at all times on +our website, https://data.catering/about/ under Privacy or on request. To contact us, refer to the “How +to contact us” section below.

+

We provide access to your personal information stored by Peter John Flook

+

You can request access to your personal information stored by Peter John Flook. To contact us, refer to the “How to +contact us” section below. Upon receiving such a request, Peter John Flook will:

+

inform you about what type of personal information we have on record or in our control, how it is used and to whom it +may have been disclosed +provide you with access to your information so you can review and verify the accuracy and completeness and request +changes to the information +make any necessary updates to your personal information +We respond to your questions, concerns and complaints about privacy +Peter John Flook responds in a timely manner to your questions, concerns and complaints about the privacy of your +personal +information and our privacy policies and procedures.

+

How to contact us

+
    +
  • by email at peter.flook@data.catering
    • +
+

Our business changes constantly, and this privacy notice will change also. We may e-mail periodic reminders of our +notices and conditions, unless you have instructed us not to, but you should check our website frequently to see +recent +changes. We are, however, committed to protecting your information and will never materially change our policies and +practices to make them less protective of customer information collected in the past without the consent of affected +customers.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/legal/terms-of-service/index.html b/legal/terms-of-service/index.html new file mode 100644 index 00000000..977b0206 --- /dev/null +++ b/legal/terms-of-service/index.html @@ -0,0 +1,2115 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Terms of service - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Terms and Conditions

+

Last updated: September 25, 2023

+

Please read these terms and conditions carefully before using Our Service.

+

Interpretation and Definitions

+

Interpretation

+

The words of which the initial letter is capitalized have meanings defined under the following conditions. The following +definitions shall have the same meaning regardless of whether they appear in singular or in plural.

+

Definitions

+

For the purposes of these Terms and Conditions:

+
    +
  • Application means the software program provided by the Company downloaded by You on any electronic device, named + Data Caterer
    • +
  • Application Store means the digital distribution service operated and developed by Docker Inc. (“Docker”) in which + the Application has been downloaded.
    • +
  • Affiliate means an entity that controls, is controlled by or is under common control with a party, where "control" + means ownership of 50% or more of the shares, equity interest or other securities entitled to vote for election of + directors or other managing authority.
    • +
  • Country refers to: New South Wales, Australia
    • +
  • Company (referred to as either "the Company", "We", "Us" or "Our" in this Agreement) refers to Peter John Flook ( + ABN: 65153160916), 30 Anne William Drive, West Pennant Hills, 2125, NSW, Australia.
    • +
  • Device means any device that can access the Service such as a computer, a cellphone or a digital tablet.
    • +
  • Service refers to the Application.
    • +
  • Terms and Conditions (also referred as "Terms") mean these Terms and Conditions that form the entire agreement + between You and the Company regarding the use of the Service.
    • +
  • Third-party Social Media Service means any services or content (including data, information, products or services) + provided by a third party that may be displayed, included or made available by the Service.
    • +
  • You means the individual accessing or using the Service, or the company, or other legal entity on behalf of which + such individual is accessing or using the Service, as applicable.
    • +
+

Acknowledgment

+

These are the Terms and Conditions governing the use of this Service and the agreement that operates between You and the +Company. These Terms and Conditions set out the rights and obligations of all users regarding the use of the Service.

+

Your access to and use of the Service is conditioned on Your acceptance of and compliance with these Terms and +Conditions. These Terms and Conditions apply to all visitors, users and others who access or use the Service.

+

By accessing or using the Service You agree to be bound by these Terms and Conditions. If You disagree with any part of +these Terms and Conditions then You may not access the Service.

+

You represent that you are over the age of 18. The Company does not permit those under 18 to use the Service.

+

Your access to and use of the Service is also conditioned on Your acceptance of and compliance with the Privacy Policy +of the Company. Our Privacy Policy describes Our policies and procedures on the collection, use and disclosure of Your +personal information when You use the Application or the Website and tells You about Your privacy rights and how the law +protects You. Please read Our Privacy Policy carefully before using Our Service.

+

Links to Other Websites

+

Our Service may contain links to third-party websites or services that are not owned or controlled by the Company.

+

The Company has no control over, and assumes no responsibility for, the content, privacy policies, or practices of any +third party websites or services. You further acknowledge and agree that the Company shall not be responsible or +liable, directly or indirectly, for any damage or loss caused or alleged to be caused by or in connection with the use +of or reliance on any such content, goods or services available on or through any such websites or services.

+

We strongly advise You to read the terms and conditions and privacy policies of any third-party websites or services +that You visit.

+

Termination

+

We may terminate or suspend Your access immediately, without prior notice or liability, for any reason whatsoever, +including without limitation if You breach these Terms and Conditions.

+

Upon termination, Your right to use the Service will cease immediately.

+

Limitation of Liability

+

Notwithstanding any damages that You might incur, the entire liability of the Company and any of its suppliers under any +provision of these Terms and Your exclusive remedy for all the foregoing shall be limited to the amount actually paid +by You through the Service or 100 USD if You haven't purchased anything through the Service.

+

To the maximum extent permitted by applicable law, in no event shall the Company or its suppliers be liable for any +special, incidental, indirect, or consequential damages whatsoever (including, but not limited to, damages for loss of +profits, loss of data or other information, for business interruption, for personal injury, loss of privacy arising out +of or in any way related to the use of or inability to use the Service, third-party software and/or third-party hardware +used with the Service, or otherwise in connection with any provision of these Terms), even if the Company or any +supplier has been advised of the possibility of such damages and even if the remedy fails of its essential purpose.

+

Some states do not allow the exclusion of implied warranties or limitation of liability for incidental or consequential +damages, which means that some of the above limitations may not apply. In these states, each party's liability will be +limited to the greatest extent permitted by law.

+

"AS IS" and "AS AVAILABLE" Disclaimer

+

The Service is provided to You "AS IS" and "AS AVAILABLE" and with all faults and defects without warranty of any kind. +To the maximum extent permitted under applicable law, the Company, on its own behalf and on behalf of its Affiliates and +its and their respective licensors and service providers, expressly disclaims all warranties, whether express, implied, +statutory or otherwise, with respect to the Service, including all implied warranties of merchantability, fitness for a +particular purpose, title and non-infringement, and warranties that may arise out of course of dealing, course of +performance, usage or trade practice. Without limitation to the foregoing, the Company provides no warranty or +undertaking, and makes no representation of any kind that the Service will meet Your requirements, achieve any intended +results, be compatible or work with any other software, applications, systems or services, operate without interruption, +meet any performance or reliability standards or be error free or that any errors or defects can or will be corrected.

+

Without limiting the foregoing, neither the Company nor any of the company's provider makes any representation or +warranty of any kind, express or implied: (i) as to the operation or availability of the Service, or the information, +content, and materials or products included thereon; (ii) that the Service will be uninterrupted or error-free; (iii) as +to the accuracy, reliability, or currency of any information or content provided through the Service; or (iv) that the +Service, its servers, the content, or e-mails sent from or on behalf of the Company are free of viruses, scripts, trojan +horses, worms, malware, time-bombs or other harmful components.

+

Some jurisdictions do not allow the exclusion of certain types of warranties or limitations on applicable statutory +rights of a consumer, so some or all of the above exclusions and limitations may not apply to You. But in such a case +the exclusions and limitations set forth in this section shall be applied to the greatest extent enforceable under +applicable law.

+

Governing Law

+

The laws of the Country, excluding its conflicts of law rules, shall govern this Terms and Your use of the Service. Your +use of the Application may also be subject to other local, state, national, or international laws.

+

Disputes Resolution

+

If You have any concern or dispute about the Service, You agree to first try to resolve the dispute informally by +contacting the Company.

+

For European Union (EU) Users

+

If You are a European Union consumer, you will benefit from any mandatory provisions of the law of the country in which +you are resident in.

+

United States Legal Compliance

+

You represent and warrant that (i) You are not located in a country that is subject to the United States government +embargo, or that has been designated by the United States government as a "terrorist supporting" country, and (ii) You +are not listed on any United States government list of prohibited or restricted parties.

+

Severability and Waiver

+

Severability

+

If any provision of these Terms is held to be unenforceable or invalid, such provision will be changed and interpreted +to accomplish the objectives of such provision to the greatest extent possible under applicable law and the remaining +provisions will continue in full force and effect.

+

Waiver

+

Except as provided herein, the failure to exercise a right or to require performance of an obligation under these Terms +shall not affect a party's ability to exercise such right or require such performance at any time thereafter nor shall +the waiver of a breach constitute a waiver of any subsequent breach.

+

Translation Interpretation

+

These Terms and Conditions may have been translated if We have made them available to You on our Service. +You agree that the original English text shall prevail in the case of a dispute.

+

Changes to These Terms and Conditions

+

We reserve the right, at Our sole discretion, to modify or replace these Terms at any time. If a revision is material We +will make reasonable efforts to provide at least 30 days' notice prior to any new terms taking effect. What constitutes +a material change will be determined at Our sole discretion.

+

By continuing to access or use Our Service after those revisions become effective, You agree to be bound by the revised +terms. If You do not agree to the new terms, in whole or in part, please stop using the website and the Service.

+

Contact Us

+

If you have any questions about these Terms and Conditions, You can contact us:

+
    +
  • By email: peter.flook@data.catering
    • +
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/pricing/index.html b/pricing/index.html new file mode 100644 index 00000000..c7d3fc63 --- /dev/null +++ b/pricing/index.html @@ -0,0 +1,2081 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + Pricing - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Pricing

+

To have access to the paid features of Data Caterer, you can subscribe according to your situation. You will not be +charged by usage. As you continue to subscribe, you will have access to the latest version of Data Caterer as new +bug fixes and features get published.

+ +
    +
  • Metadata discovery
    • +
  • All data sources (see here for all data sources)
    • +
  • Batch and Event generation
    • +
  • Auto generation from data connections or metadata sources
    • +
  • Suggest data validations
    • +
  • Clean up generated data
    • +
  • Run as many times as you want, not charged by usage
    • +
+

Pricing Table

+ +

+

+

Manage Subscription

+

Manage via this link

+

Contact

+

Please contact Peter Flook +via Slack +or via email peter.flook@data.catering if you have any questions or queries.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/sample/datafaker/expressions.txt b/sample/datafaker/expressions.txt new file mode 100644 index 00000000..55799fb8 --- /dev/null +++ b/sample/datafaker/expressions.txt @@ -0,0 +1,1024 @@ +Address.buildingNumber +Address.city +Address.cityName +Address.cityPrefix +Address.citySuffix +Address.country +Address.countryCode +Address.countyByZipCode +Address.fullAddress +Address.latLon +Address.latitude +Address.lonLat +Address.longitude +Address.mailBox +Address.postcode +Address.secondaryAddress +Address.state +Address.stateAbbr +Address.streetAddress +Address.streetAddressNumber +Address.streetName +Address.streetPrefix +Address.streetSuffix +Address.timeZone +Address.zipCode +Address.zipCodeByState +Address.zipCodePlus4 +Ancient.god +Ancient.hero +Ancient.primordial +Ancient.titan +Animal.genus +Animal.name +Animal.scientificName +Animal.species +App.author +App.name +App.version +Appliance.brand +Appliance.equipment +AquaTeenHungerForce.character +Artist.name +Australia.animals +Australia.locations +Australia.states +Avatar.image +Aviation.METAR +Aviation.aircraft +Aviation.airline +Aviation.airport +Aviation.flight +Aws.accountId +Aws.acmARN +Aws.albARN +Aws.albTargetGroupARN +Aws.region +Aws.route53ZoneId +Aws.securityGroupId +Aws.subnetId +Aws.vpcId +Azure.appServiceEnvironment +Azure.appServicePlan +Azure.applicationGateway +Azure.bastionHost +Azure.containerApps +Azure.containerAppsEnvironment +Azure.containerInstance +Azure.containerRegistry +Azure.cosmosDBDatabase +Azure.firewall +Azure.keyVault +Azure.loadBalancer +Azure.loadTesting +Azure.logAnalytics +Azure.managementGroup +Azure.mysqlDatabase +Azure.networkSecurityGroup +Azure.postgreSQLDatabase +Azure.region +Azure.resourceGroup +Azure.serviceBus +Azure.serviceBusQueue +Azure.serviceBusTopic +Azure.sqlDatabase +Azure.staticWebApp +Azure.storageAccount +Azure.subscriptionId +Azure.tenantId +Azure.virtualMachine +Azure.virtualNetwork +Azure.virtualWan +Babylon5.character +Babylon5.quote +BackToTheFuture.character +BackToTheFuture.date +BackToTheFuture.quote +Barcode.type +Baseball.coaches +Baseball.players +Baseball.positions +Baseball.teams +Basketball.coaches +Basketball.players +Basketball.positions +Basketball.teams +Battlefield1.classes +Battlefield1.faction +Battlefield1.map +Battlefield1.vehicle +Battlefield1.weapon +Beer.brand +Beer.hop +Beer.malt +Beer.name +Beer.style +Beer.yeast +BigBangTheory.character +BigBangTheory.quote +BloodType.aboTypes +BloodType.bloodGroup +BloodType.pTypes +BloodType.rhTypes +BojackHorseman.characters +BojackHorseman.quotes +BojackHorseman.tongueTwisters +Book.author +Book.genre +Book.publisher +Book.title +BossaNova.artist +BossaNova.song +Brand.car +Brand.sport +Brand.watch +BreakingBad.character +BreakingBad.episode +BrooklynNineNine.characters +BrooklynNineNine.quotes +Buffy.bigBads +Buffy.celebrities +Buffy.characters +Buffy.episodes +Buffy.quotes +Business.creditCardExpiry +Business.creditCardNumber +Business.creditCardType +Business.securityCode +CNPJ.invalid +CNPJ.valid +CPF.invalid +CPF.valid +Camera.brand +Camera.brandWithModel +Camera.model +Cannabis.brands +Cannabis.buzzwords +Cannabis.cannabinoidAbbreviations +Cannabis.cannabinoids +Cannabis.categories +Cannabis.healthBenefits +Cannabis.medicalUses +Cannabis.strains +Cannabis.terpenes +Cannabis.types +Cat.breed +Cat.name +Cat.registry +Chess.opening +Chess.player +Chess.title +Chess.tournament +Chiquito.expressions +Chiquito.jokes +Chiquito.sentences +Chiquito.terms +ChuckNorris.fact +ClashOfClans.defensiveBuilding +ClashOfClans.rank +ClashOfClans.troop +Code.asin +Code.ean13 +Code.ean8 +Code.gtin13 +Code.gtin8 +Code.imei +Code.isbn10 +Code.isbn13 +Code.isbnGroup +Code.isbnGs1 +Code.isbnRegistrant +Coffee.blendName +Coffee.body +Coffee.country +Coffee.descriptor +Coffee.intensifier +Coffee.name1 +Coffee.name2 +Coffee.notes +Coffee.region +Coffee.variety +Coin.flip +Color.hex +Color.name +Commerce.brand +Commerce.department +Commerce.material +Commerce.price +Commerce.productName +Commerce.promotionCode +Commerce.vendor +Community.character +Community.quote +Company.bs +Company.buzzword +Company.catchPhrase +Company.industry +Company.logo +Company.name +Company.profession +Company.suffix +Company.url +Compass.abbreviation +Compass.azimuth +Compass.word +Computer.brand +Computer.linux +Computer.macos +Computer.operatingSystem +Computer.platform +Computer.type +Computer.windows +Construction.heavyEquipment +Construction.materials +Construction.roles +Construction.standardCostCodes +Construction.subcontractCategories +Construction.trades +Control.alteredItem +Control.alteredWorldEvent +Control.character +Control.hiss +Control.location +Control.objectOfPower +Control.quote +Control.theBoard +Cosmere.allomancers +Cosmere.aons +Cosmere.feruchemists +Cosmere.heralds +Cosmere.knightsRadiant +Cosmere.metals +Cosmere.shardWorlds +Cosmere.shards +Cosmere.sprens +Cosmere.surges +Country.capital +Country.countryCode2 +Country.countryCode3 +Country.currency +Country.currencyCode +Country.flag +Country.name +CowboyBebop.character +CowboyBebop.episode +CowboyBebop.quote +CowboyBebop.song +Cricket.formats +Cricket.players +Cricket.teams +Cricket.tournaments +CryptoCoin.coin +CultureSeries.books +CultureSeries.civs +CultureSeries.cultureShipClassAbvs +CultureSeries.cultureShipClasses +CultureSeries.cultureShips +CultureSeries.planets +Currency.code +Currency.name +DarkSouls.classes +DarkSouls.covenants +DarkSouls.shield +DarkSouls.stats +DateAndTime.between +DateAndTime.birthday +DateAndTime.future +DateAndTime.past +DcComics.hero +DcComics.heroine +DcComics.name +DcComics.title +DcComics.villain +Demographic.demonym +Demographic.educationalAttainment +Demographic.maritalStatus +Demographic.race +Demographic.sex +Departed.actor +Departed.character +Departed.quote +Dessert.flavor +Dessert.topping +Dessert.variety +DetectiveConan.characters +DetectiveConan.gadgets +DetectiveConan.vehicles +Device.manufacturer +Device.modelName +Device.platform +Device.serial +Disease.dermatology +Disease.dermatolory +Disease.gynecologyAndObstetrics +Disease.internalDisease +Disease.neurology +Disease.ophthalmologyAndOtorhinolaryngology +Disease.paediatrics +Disease.surgery +DoctorWho.actor +DoctorWho.catchPhrase +DoctorWho.character +DoctorWho.doctor +DoctorWho.quote +DoctorWho.species +DoctorWho.villain +Dog.age +Dog.breed +Dog.coatLength +Dog.gender +Dog.memePhrase +Dog.name +Dog.size +Dog.sound +Domain.firstLevelDomain +Domain.fullDomain +Domain.secondLevelDomain +Domain.validDomain +Doraemon.character +Doraemon.gadget +Doraemon.location +DragonBall.character +DrivingLicense.drivingLicense +Drone.batteryCapacity +Drone.batteryType +Drone.batteryVoltage +Drone.batteryWeight +Drone.chargingTemperature +Drone.flightTime +Drone.iso +Drone.maxAltitude +Drone.maxAngularVelocity +Drone.maxAscentSpeed +Drone.maxChargingPower +Drone.maxDescentSpeed +Drone.maxFlightDistance +Drone.maxResolution +Drone.maxShutterSpeed +Drone.maxSpeed +Drone.maxTiltAngle +Drone.maxWindResistance +Drone.minShutterSpeed +Drone.name +Drone.operatingTemperature +Drone.photoFormat +Drone.shutterSpeedUnits +Drone.videoFormat +Drone.weight +DumbAndDumber.actor +DumbAndDumber.character +DumbAndDumber.quote +Dune.character +Dune.planet +Dune.quote +Dune.saying +Dune.title +DungeonsAndDragons.alignments +DungeonsAndDragons.backgrounds +DungeonsAndDragons.cities +DungeonsAndDragons.klasses +DungeonsAndDragons.languages +DungeonsAndDragons.meleeWeapons +DungeonsAndDragons.monsters +DungeonsAndDragons.races +DungeonsAndDragons.rangedWeapons +Educator.campus +Educator.course +Educator.secondarySchool +Educator.subjectWithNumber +Educator.university +EldenRing.location +EldenRing.npc +EldenRing.skill +EldenRing.spell +EldenRing.weapon +ElderScrolls.city +ElderScrolls.creature +ElderScrolls.dragon +ElderScrolls.firstName +ElderScrolls.lastName +ElderScrolls.quote +ElderScrolls.race +ElderScrolls.region +ElectricalComponents.active +ElectricalComponents.electromechanical +ElectricalComponents.passive +Emoji.cat +Emoji.smiley +EnglandFootBall.league +EnglandFootBall.team +Esports.event +Esports.game +Esports.league +Esports.player +Esports.team +Fallout.character +Fallout.faction +Fallout.location +Fallout.quote +FamilyGuy.character +FamilyGuy.location +FamilyGuy.quote +FamousLastWords.lastWords +File.extension +File.fileName +File.mimeType +FinalSpace.character +FinalSpace.quote +FinalSpace.vehicle +Finance.bic +Finance.creditCard +Finance.iban +Finance.nasdaqTicker +Finance.nyseTicker +Finance.stockMarket +Food.dish +Food.fruit +Food.ingredient +Food.measurement +Food.spice +Food.sushi +Food.vegetable +Football.coaches +Football.competitions +Football.players +Football.positions +Football.teams +Formula1.circuit +Formula1.driver +Formula1.grandPrix +Formula1.team +FreshPrinceOfBelAir.celebrities +FreshPrinceOfBelAir.characters +FreshPrinceOfBelAir.quotes +Friends.character +Friends.location +Friends.quote +FullmetalAlchemist.character +FullmetalAlchemist.city +FullmetalAlchemist.country +FunnyName.name +Futurama.character +Futurama.hermesCatchPhrase +Futurama.location +Futurama.quote +GameOfThrones.character +GameOfThrones.city +GameOfThrones.dragon +GameOfThrones.house +GameOfThrones.quote +GarmentSize.size +Gender.binaryTypes +Gender.shortBinaryTypes +Gender.types +Ghostbusters.actor +Ghostbusters.character +Ghostbusters.quote +GratefulDead.players +GratefulDead.songs +GreekPhilosopher.name +GreekPhilosopher.quote +Hacker.abbreviation +Hacker.adjective +Hacker.ingverb +Hacker.noun +Hacker.verb +HalfLife.character +HalfLife.enemy +HalfLife.location +HarryPotter.book +HarryPotter.character +HarryPotter.house +HarryPotter.location +HarryPotter.quote +HarryPotter.spell +Hashing.md2 +Hashing.md5 +Hashing.sha1 +Hashing.sha256 +Hashing.sha384 +Hashing.sha512 +Hearthstone.mainCharacter +Hearthstone.mainPattern +Hearthstone.mainProfession +Hearthstone.standardRank +Hearthstone.wildRank +HeroesOfTheStorm.battleground +HeroesOfTheStorm.hero +HeroesOfTheStorm.heroClass +HeroesOfTheStorm.quote +HeyArnold.characters +HeyArnold.locations +HeyArnold.quotes +Hipster.word +HitchhikersGuideToTheGalaxy.character +HitchhikersGuideToTheGalaxy.location +HitchhikersGuideToTheGalaxy.marvinQuote +HitchhikersGuideToTheGalaxy.planet +HitchhikersGuideToTheGalaxy.quote +HitchhikersGuideToTheGalaxy.species +HitchhikersGuideToTheGalaxy.starship +Hobbit.character +Hobbit.location +Hobbit.quote +Hobbit.thorinsCompany +Hobby.activity +Hololive.talent +Horse.breed +Horse.name +House.furniture +House.room +HowIMetYourMother.catchPhrase +HowIMetYourMother.character +HowIMetYourMother.highFive +HowIMetYourMother.quote +HowToTrainYourDragon.characters +HowToTrainYourDragon.dragons +HowToTrainYourDragon.locations +IdNumber.inValidEnZaSsn +IdNumber.invalid +IdNumber.invalidEsMXSsn +IdNumber.invalidPtNif +IdNumber.invalidSvSeSsn +IdNumber.peselNumber +IdNumber.singaporeanFin +IdNumber.singaporeanFinBefore2000 +IdNumber.singaporeanUin +IdNumber.singaporeanUinBefore2000 +IdNumber.ssnValid +IdNumber.valid +IdNumber.validEnZaSsn +IdNumber.validEsMXSsn +IdNumber.validKoKrRrn +IdNumber.validPtNif +IdNumber.validSvSeSsn +IdNumber.validZhCNSsn +IndustrySegments.industry +IndustrySegments.sector +IndustrySegments.subSector +IndustrySegments.superSector +Internet.botUserAgent +Internet.botUserAgentAny +Internet.domainName +Internet.domainSuffix +Internet.domainWord +Internet.emailAddress +Internet.httpMethod +Internet.image +Internet.ipV4Address +Internet.ipV4Cidr +Internet.ipV6Address +Internet.ipV6Cidr +Internet.macAddress +Internet.password +Internet.privateIpV4Address +Internet.publicIpV4Address +Internet.safeEmailAddress +Internet.slug +Internet.url +Internet.userAgent +Internet.uuid +Internet.uuidv3 +Job.field +Job.keySkills +Job.position +Job.seniority +Job.title +Kaamelott.character +Kaamelott.quote +Kpop.boyBands +Kpop.girlGroups +Kpop.iGroups +Kpop.iiGroups +Kpop.iiiGroups +Kpop.solo +LeagueOfLegends.champion +LeagueOfLegends.location +LeagueOfLegends.masteries +LeagueOfLegends.quote +LeagueOfLegends.rank +LeagueOfLegends.summonerSpell +Lebowski.actor +Lebowski.character +Lebowski.quote +Locality.displayName +Locality.localeString +Locality.localeStringWithRandom +Locality.localeStringWithoutReplacement +LordOfTheRings.character +LordOfTheRings.location +Lorem.characters +Lorem.fixedString +Lorem.maxLengthSentence +Lorem.paragraph +Lorem.sentence +Lorem.word +Marketing.buzzwords +MarvelSnap.character +MarvelSnap.event +MarvelSnap.rank +MarvelSnap.zone +MassEffect.character +MassEffect.cluster +MassEffect.planet +MassEffect.quote +MassEffect.specie +Matz.quote +Mbti.characteristic +Mbti.merit +Mbti.name +Mbti.personage +Mbti.type +Mbti.weakness +Measurement.height +Measurement.length +Measurement.metricHeight +Measurement.metricLength +Measurement.metricVolume +Measurement.metricWeight +Measurement.volume +Measurement.weight +Medical.diagnosisCode +Medical.diseaseName +Medical.hospitalName +Medical.medicineName +Medical.procedureCode +Medical.symptoms +Military.airForceRank +Military.armyRank +Military.dodPaygrade +Military.marinesRank +Military.navyRank +Minecraft.animalName +Minecraft.entityName +Minecraft.itemName +Minecraft.monsterName +Minecraft.tileItemName +Minecraft.tileName +Money.currency +Money.currencyCode +MoneyHeist.character +MoneyHeist.heist +MoneyHeist.quote +Mood.emotion +Mood.feeling +Mood.tone +Mountain.name +Mountain.range +Mountaineering.mountaineer +Movie.quote +Music.chord +Music.genre +Music.instrument +Music.key +Myst.ages +Myst.characters +Myst.creatures +Myst.games +Myst.quotes +Name.firstName +Name.fullName +Name.lastName +Name.name +Name.nameWithMiddle +Name.prefix +Name.suffix +Name.title +Name.username +Naruto.character +Naruto.demon +Naruto.eye +Naruto.village +Nation.capitalCity +Nation.flag +Nation.isoCountry +Nation.isoLanguage +Nation.language +Nation.nationality +NatoPhoneticAlphabet.codeWord +NewGirl.characters +NewGirl.quotes +Nigeria.celebrities +Nigeria.food +Nigeria.name +Nigeria.places +Nigeria.schools +Number.digit +Number.digits +OlympicSport.ancientOlympics +OlympicSport.summerOlympics +OlympicSport.summerParalympics +OlympicSport.unusual +OlympicSport.winterOlympics +OlympicSport.winterParalympics +OnePiece.akumasNoMi +OnePiece.character +OnePiece.island +OnePiece.location +OnePiece.quote +OnePiece.sea +Options.option +OscarMovie.actor +OscarMovie.character +OscarMovie.getChoice +OscarMovie.getYear +OscarMovie.movieName +OscarMovie.quote +OscarMovie.releaseDate +Overwatch.hero +Overwatch.location +Overwatch.quote +Passport.valid +PhoneNumber.cellPhone +PhoneNumber.extension +PhoneNumber.phoneNumber +PhoneNumber.phoneNumberInternational +PhoneNumber.phoneNumberNational +PhoneNumber.subscriberNumber +Photography.aperture +Photography.brand +Photography.camera +Photography.genre +Photography.imageTag +Photography.iso +Photography.lens +Photography.shutter +Photography.term +Pokemon.location +Pokemon.move +Pokemon.name +Pokemon.type +PrincessBride.character +PrincessBride.quote +ProgrammingLanguage.creator +ProgrammingLanguage.name +Relationship.any +Relationship.direct +Relationship.extended +Relationship.inLaw +Relationship.parent +Relationship.sibling +Relationship.spouse +ResidentEvil.biologicalAgent +ResidentEvil.character +ResidentEvil.creature +ResidentEvil.equipment +ResidentEvil.location +Restaurant.description +Restaurant.name +Restaurant.namePrefix +Restaurant.nameSuffix +Restaurant.review +Restaurant.type +RickAndMorty.character +RickAndMorty.location +RickAndMorty.quote +Robin.quote +RockBand.name +RuPaulDragRace.queen +RuPaulDragRace.quote +Science.bosons +Science.element +Science.elementSymbol +Science.leptons +Science.quark +Science.scientist +Science.tool +Science.unit +Seinfeld.business +Seinfeld.character +Seinfeld.quote +Shakespeare.asYouLikeItQuote +Shakespeare.hamletQuote +Shakespeare.kingRichardIIIQuote +Shakespeare.romeoAndJulietQuote +Show.adultMusical +Show.kidsMusical +Show.play +SiliconValley.app +SiliconValley.character +SiliconValley.company +SiliconValley.email +SiliconValley.invention +SiliconValley.motto +SiliconValley.quote +SiliconValley.url +Simpsons.character +Simpsons.location +Simpsons.quote +Sip.bodyString +Sip.clientErrorResponsePhrase +Sip.contentType +Sip.globalErrorResponsePhrase +Sip.method +Sip.nameAddress +Sip.provisionalResponsePhrase +Sip.redirectResponsePhrase +Sip.serverErrorResponsePhrase +Sip.successResponsePhrase +Size.adjective +SlackEmoji.activity +SlackEmoji.celebration +SlackEmoji.custom +SlackEmoji.emoji +SlackEmoji.foodAndDrink +SlackEmoji.nature +SlackEmoji.objectsAndSymbols +SlackEmoji.people +SlackEmoji.travelAndPlaces +SonicTheHedgehog.character +SonicTheHedgehog.game +SonicTheHedgehog.zone +SoulKnight.bosses +SoulKnight.buffs +SoulKnight.characters +SoulKnight.enemies +SoulKnight.statues +SoulKnight.weapons +SouthPark.characters +SouthPark.quotes +Space.agency +Space.agencyAbbreviation +Space.company +Space.constellation +Space.distanceMeasurement +Space.galaxy +Space.meteorite +Space.moon +Space.nasaSpaceCraft +Space.nebula +Space.planet +Space.star +Space.starCluster +Spongebob.characters +Spongebob.episodes +Spongebob.quotes +StarCraft.building +StarCraft.character +StarCraft.planet +StarCraft.unit +StarTrek.character +StarTrek.klingon +StarTrek.location +StarTrek.species +StarTrek.villain +StarWars.alternateCharacterSpelling +StarWars.callSign +StarWars.character +StarWars.droids +StarWars.planets +StarWars.quotes +StarWars.species +StarWars.vehicles +StarWars.wookieWords +Stargate.characters +Stargate.planets +Stargate.quotes +Stock.nsdqSymbol +Stock.nyseSymbol +StrangerThings.character +StrangerThings.quote +StreetFighter.characters +StreetFighter.moves +StreetFighter.quotes +StreetFighter.stages +StudioGhibli.character +StudioGhibli.movie +StudioGhibli.quote +Subscription.paymentMethods +Subscription.paymentTerms +Subscription.plans +Subscription.statuses +Subscription.subscriptionTerms +Suits.characters +Suits.quotes +SuperMario.characters +SuperMario.games +SuperMario.locations +SuperSmashBros.fighter +SuperSmashBros.stage +Superhero.descriptor +Superhero.name +Superhero.power +Superhero.prefix +Superhero.suffix +Supernatural.character +Supernatural.creature +Supernatural.weapon +SwordArtOnline.gameName +SwordArtOnline.item +SwordArtOnline.location +SwordArtOnline.realName +Tea.type +Tea.variety +Team.creature +Team.name +Team.sport +Team.state +Text.text +TheExpanse.characters +TheExpanse.locations +TheExpanse.quotes +TheExpanse.ships +TheItCrowd.actors +TheItCrowd.characters +TheItCrowd.emails +TheItCrowd.quotes +TheKingkillerChronicle.book +TheKingkillerChronicle.character +TheKingkillerChronicle.creature +TheKingkillerChronicle.location +TheRoom.actors +TheRoom.characters +TheRoom.locations +TheRoom.quotes +TheThickOfIt.characters +TheThickOfIt.departments +TheThickOfIt.positions +TheVentureBros.character +TheVentureBros.organization +TheVentureBros.quote +TheVentureBros.vehicle +Time.between +Time.future +Time.past +Touhou.characterFirstName +Touhou.characterLastName +Touhou.characterName +Touhou.gameName +Touhou.trackName +Tron.alternateCharacterSpelling +Tron.character +Tron.game +Tron.location +Tron.quote +Tron.tagline +Tron.vehicle +TwinPeaks.character +TwinPeaks.location +TwinPeaks.quote +Twitter.getLink +Twitter.text +Twitter.twitterId +Twitter.userId +Twitter.userName +Unique.fetchFromYaml +University.name +University.prefix +University.suffix +VForVendetta.characters +VForVendetta.quotes +VForVendetta.speeches +Vehicle.carType +Vehicle.color +Vehicle.doors +Vehicle.driveType +Vehicle.engine +Vehicle.fuelType +Vehicle.licensePlate +Vehicle.make +Vehicle.makeAndModel +Vehicle.manufacturer +Vehicle.model +Vehicle.style +Vehicle.transmission +Vehicle.upholstery +Vehicle.upholsteryColor +Vehicle.upholsteryFabric +Vehicle.vin +Verb.base +Verb.ingForm +Verb.past +Verb.pastParticiple +Verb.simplePresent +VideoGame.genre +VideoGame.platform +VideoGame.title +Volleyball.coach +Volleyball.formation +Volleyball.player +Volleyball.position +Volleyball.team +WarhammerFantasy.creatures +WarhammerFantasy.factions +WarhammerFantasy.heros +WarhammerFantasy.locations +WarhammerFantasy.quotes +Weather.description +Weather.temperatureCelsius +Weather.temperatureFahrenheit +Witcher.book +Witcher.character +Witcher.location +Witcher.monster +Witcher.potion +Witcher.quote +Witcher.school +Witcher.sign +Witcher.witcher +WorldOfWarcraft.hero +WorldOfWarcraft.quotes +Yoda.quote +Zelda.character +Zelda.game +Zodiac.sign \ No newline at end of file diff --git a/sample/report/html/data-sources.html b/sample/report/html/data-sources.html new file mode 100644 index 00000000..698c7919 --- /dev/null +++ b/sample/report/html/data-sources.html @@ -0,0 +1,178 @@ + + + + Data Source Details - Data Caterer + + + +
+ + + Data Caterer + +

Data Sources

+ + + + + + + + + + + + + + + + + + + + + + + + + +
NameNum RecordsSuccessFormatOptions
+ my_json + + 2000 + + ✅ + + json + + + + + + + + + + + +
+ + saveMode + + + overwrite +
+ + format + + + json +
+ + path + + + /tmp/data/json +
+
+ my_csv + + 1000 + + ✅ + + json + + + + + + + + + + + +
+ + saveMode + + + overwrite +
+ + format + + + json +
+ + path + + + /tmp/data/csv +
+
+ + \ No newline at end of file diff --git a/sample/report/html/data_catering_transparent.svg b/sample/report/html/data_catering_transparent.svg new file mode 100644 index 00000000..cc6a8d60 --- /dev/null +++ b/sample/report/html/data_catering_transparent.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/sample/report/html/index.html b/sample/report/html/index.html new file mode 100644 index 00000000..7e69d20f --- /dev/null +++ b/sample/report/html/index.html @@ -0,0 +1,275 @@ + + + + Data Caterer + + +
+ + + Data Caterer + +
+

Data Caterer Summary

+

Flags

+ + + + + + + + + + + + + + + + + + + + + + +
Generate MetadataGenerate DataRecord TrackingDelete DataCalculate Generated Records MetadataValidate DataUnique Check
+ ❌ + + ✅ + + ❌ + + ❌ + + ✅ + + ✅ + + ❌ +

Plan

+ + + + + + + + + + + + + + + + + + + + + + +
Plan NameNum RecordsSuccessTasksStepsData SourcesForeign Keys
+ Default plan + + 3000 + + ✅ + + 2 + + 2 + + 2 + + +

Tasks

+ + + + + + + + + + + + + + + + + + + + + +
NameNum RecordsSuccessSteps
+ + 455595ef-9b9c-4965-b721-51e13036119b + + + 2000 + + ✅ + + + fec4ad7f-4f70-4ec0-971d-2a15b0e1619d + +
+ + f7704634-c247-4a80-ae05-b5ac8853363c + + + 1000 + + ✅ + + + 89ba1628-281d-4503-bcc5-6f393db4b4cb + +

Validations

+ + + + + + + + + + + + + + + + + + + + + +
NameData SourcesDescriptionSuccess
+ + default_validation + + + + my_json + + + Validation of data sources after generating data + +
+
+
+ 1/2 (50.00%) +
+
+ + default_validation + + + + my_csv + + + Validation of data sources after generating data + +
+
+
+ 2/2 (100.00%) +
+

Output Rows Per Second

+ Generated at + 2023-10-13T09:14:15.727+08:00 +
+
+ + \ No newline at end of file diff --git a/sample/report/html/main.css b/sample/report/html/main.css new file mode 100644 index 00000000..e07128fc --- /dev/null +++ b/sample/report/html/main.css @@ -0,0 +1,173 @@ +.box-iframe { + float: left; + margin-right: 10px; +} + +body { + margin: 0; +} + +.top-banner { + height: fit-content; + background-color: #ff6e42; + padding: 0 .2rem; + display: flex; +} + +.top-banner span { + color: #f2f2f2; + font-size: 17px; + padding: 5px 6px; + display: flex; + align-items: center; +} + +.logo { + padding: 5px; + height: 45px; + width: auto; + display: flex; + align-items: center; + justify-content: center; +} + +.logo:hover { + background-color: #ff9100; + color: black; +} + +.top-banner img { + height: 35px; + width: auto; + display: flex; + justify-content: center; + vertical-align: middle; +} + +.topnav { + overflow: hidden; + background-color: #ff6e42; +} + +.topnav a { + float: left; + color: #f2f2f2; + text-align: center; + padding: 8px 10px; + text-decoration: none; + font-size: 17px; +} + +.topnav a:hover { + background-color: #ff9100; + color: black; +} + +.topnav a.active { + color: black; +} + +table { + overflow: hidden; + transition: max-height 0.2s ease-out; +} + +table.codegrid { + font-family: monospace; + font-size: 12px; + width: auto !important; +} + +table.statementlist { + width: auto !important; + font-size: 13px; +} + +table.codegrid td { + padding: 0 !important; + border: 0 !important +} + +table td.linenumber { + width: 40px !important; +} + +td { + white-space: normal +} + +.table thead th { + position: sticky; + top: 0; + z-index: 1; +} + +table, tr, td, th { + border-collapse: collapse; +} + +.table-collapsible { + max-height: 0; + overflow: hidden; + transition: max-height 0.2s ease-out; +} + +.collapsible { + background-color: lightgray; + color: black; + cursor: pointer; + width: 100%; + border: none; + text-align: left; + outline: none; +} + +.collapsible:after { + content: "\02795"; /* Unicode character for "plus" sign (+) */ + color: white; + float: right; +} + +.active:after { + content: "\2796"; /* Unicode character for "minus" sign (-) */ +} + +.outer-container { + display: flex; + flex-direction: column; + height: 100vh; +} + +.top-container { + height: 50%; + overflow: auto; + resize: vertical; +} + +.bottom-container { + flex: 1; + min-height: 0; + height: 50%; + overflow: auto; + resize: vertical; +} + +.slider { + text-align: center; + background-color: #dee2e6; + cursor: row-resize; + user-select: none; +} + +.selected-row { + background-color: #ff6e42 !important; +} + +.progress { + white-space: normal; + background-color: #d9534f; +} + +.progress-bar { + color: black; +} diff --git a/sample/report/html/steps.html b/sample/report/html/steps.html new file mode 100644 index 00000000..8bd4eb85 --- /dev/null +++ b/sample/report/html/steps.html @@ -0,0 +1,1233 @@ + + + + Step Details - Data Caterer + + + +
+ + + Data Caterer + +
+
+

Steps

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameNum RecordsSuccessTypeEnabledOptionsCountFields
+ fec4ad7f-4f70-4ec0-971d-2a15b0e1619d + + 2000 + + ✅ + + json + + ✅ + + + + + + + + + + + +
+ + saveMode + + + overwrite +
+ + format + + + json +
+ + path + + + /tmp/data/json +
+ 		+ + + + + + + + + + +
+ + countType + + + per-column-count +
+ + columns + + + account_id,name +
+ + numRecords + + + 2000 +
+ 		+ +
+
+

Field Details: + fec4ad7f-4f70-4ec0-971d-2a15b0e1619d +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeNullableGenerator TypeGenerated Records Metadata Comparison
+ account_id + + string + + ✅ + + regex + +
+ + + + + + + + + + + + + + + + + + + + +
+ Metadata Field + + Original Value + + Generated Value +
+ + regex + + + ACC[0-9]{8} + + ACC[0-9]{8} +
+ + count + + + + + 2000 +
+ + distinctCount + + + + + 1012 +
+ + maxLen + + + + + 11 +
+ + avgLen + + + + + 11 +
+ + nullCount + + + + + 0 +
+
+
+ name + + string + + ✅ + + random + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
+ Metadata Field + + Original Value + + Generated Value +
+ + count + + + + + 2000 +
+ + distinctCount + + + + + 950 +
+ + label + + + + + name +
+ + expression + + + #{Name.name} + + #{Name.name} +
+ + maxLen + + + + + 26 +
+ + avgLen + + + + + 15 +
+ + isPII + + + + + true +
+ + nullCount + + + + + 0 +
+
+
+ amount + + double + + ✅ + + random + +
+ + + + + + + + + + + + + + + + + + + + + + +
+ Metadata Field + + Original Value + + Generated Value +
+ + count + + + + + 2000 +
+ + distinctCount + + + + + 1966 +
+ + min + + + + + 0.00824904289636108 +
+ + max + + + 10 + + 9.997637072314093 +
+ + maxLen + + + + + 8 +
+ + avgLen + + + + + 8 +
+ + nullCount + + + + + 0 +
+
+
+
+
+
+ 89ba1628-281d-4503-bcc5-6f393db4b4cb + + 1000 + + ✅ + + json + + ✅ + + + + + + + + + + + +
+ + saveMode + + + overwrite +
+ + format + + + json +
+ + path + + + /tmp/data/csv +
+ 		+ + + + + + + + +
+ + countType + + + basic-count +
+ + numRecords + + + 1000 +
+ 		+ +
+
+

Field Details: + 89ba1628-281d-4503-bcc5-6f393db4b4cb +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeNullableGenerator TypeGenerated Records Metadata Comparison
+ account_number + + string + + ✅ + + regex + +
+ + + + + + + + + + + + + + + + + + + + +
+ Metadata Field + + Original Value + + Generated Value +
+ + regex + + + [0-9]{8} + + [0-9]{8} +
+ + count + + + + + 1000 +
+ + distinctCount + + + + + 938 +
+ + maxLen + + + + + 8 +
+ + avgLen + + + + + 8 +
+ + nullCount + + + + + 0 +
+
+
+ name + + string + + ✅ + + random + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
+ Metadata Field + + Original Value + + Generated Value +
+ + count + + + + + 1000 +
+ + distinctCount + + + + + 1000 +
+ + label + + + + + name +
+ + expression + + + #{Name.name} + + #{Name.name} +
+ + maxLen + + + + + 24 +
+ + avgLen + + + + + 15 +
+ + isPII + + + + + true +
+ + nullCount + + + + + 0 +
+
+
+ amount + + double + + ✅ + + random + +
+ + + + + + + + + + + + + + + + + + + + + + +
+ Metadata Field + + Original Value + + Generated Value +
+ + count + + + + + 1000 +
+ + distinctCount + + + + + 1000 +
+ + min + + + + + 0.004001642227183799 +
+ + max + + + 10 + + 9.98979849847976 +
+ + maxLen + + + + + 8 +
+ + avgLen + + + + + 8 +
+ + nullCount + + + + + 0 +
+
+
+
+
+
+
+
...
+
+
+

Field Details: + fec4ad7f-4f70-4ec0-971d-2a15b0e1619d +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeNullableGenerator TypeGenerated Records Metadata Comparison
+ account_id + + string + + ✅ + + regex + +
+ + + + + + + + + + + + + + + + + + + + +
+ Metadata Field + + Original Value + + Generated Value +
+ + regex + + + ACC[0-9]{8} + + ACC[0-9]{8} +
+ + count + + + + + 2000 +
+ + distinctCount + + + + + 1012 +
+ + maxLen + + + + + 11 +
+ + avgLen + + + + + 11 +
+ + nullCount + + + + + 0 +
+
+
+ name + + string + + ✅ + + random + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
+ Metadata Field + + Original Value + + Generated Value +
+ + count + + + + + 2000 +
+ + distinctCount + + + + + 950 +
+ + label + + + + + name +
+ + expression + + + #{Name.name} + + #{Name.name} +
+ + maxLen + + + + + 26 +
+ + avgLen + + + + + 15 +
+ + isPII + + + + + true +
+ + nullCount + + + + + 0 +
+
+
+ amount + + double + + ✅ + + random + +
+ + + + + + + + + + + + + + + + + + + + + + +
+ Metadata Field + + Original Value + + Generated Value +
+ + count + + + + + 2000 +
+ + distinctCount + + + + + 1966 +
+ + min + + + + + 0.00824904289636108 +
+ + max + + + 10 + + 9.997637072314093 +
+ + maxLen + + + + + 8 +
+ + avgLen + + + + + 8 +
+ + nullCount + + + + + 0 +
+
+
+
+
+
+ + \ No newline at end of file diff --git a/sample/report/html/tasks.html b/sample/report/html/tasks.html new file mode 100644 index 00000000..f16c945c --- /dev/null +++ b/sample/report/html/tasks.html @@ -0,0 +1,105 @@ + + + + Task Details - Data Caterer + + + +
+ + + Data Caterer + +

Tasks

+ + + + + + + + + + + + + + + + +
NameSteps
+ 455595ef-9b9c-4965-b721-51e13036119b + + + fec4ad7f-4f70-4ec0-971d-2a15b0e1619d + +
+ f7704634-c247-4a80-ae05-b5ac8853363c + + + 89ba1628-281d-4503-bcc5-6f393db4b4cb + +
+ + \ No newline at end of file diff --git a/sample/report/html/validations.html b/sample/report/html/validations.html new file mode 100644 index 00000000..78b0ff3d --- /dev/null +++ b/sample/report/html/validations.html @@ -0,0 +1,410 @@ + + + + Validations - Data Caterer + + + +
+ + + Data Caterer + +

Validations

+ + + + + + + + + + + + + + + + + + + + + +
NameData SourcesDescriptionSuccess
+ + default_validation + + + + my_json + + + Validation of data sources after generating data + +
+
+
+ 1/2 (50.00%) +
+
+ + default_validation + + + + my_csv + + + Validation of data sources after generating data + +
+
+
+ 2/2 (100.00%) +
+

Details

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
DescriptionData SourceOptionsSuccessWithin Error ThresholdValidationError Sample
+ Validate + + + my_json + + + + +
+
+
+ 2000/2000 (100.00%) +
+ 		+ ✅ + + + + + + + + + + + + + + + +
+ + expr + + + max(amount) < 100 +
+ + groupByColumns + + + account_id,name +
+ + aggregationColumn + + + amount +
+ + aggregationType + + + max +
+ + errorThreshold + + + 0.0 +
+ 		+ +
+ Validate + + + my_json + + + + +
+
+
+ 1000/2000 (50.00%) +
+ 		+ ❌ + + + + + + + + + + + + + + + +
+ + expr + + + count == 1 +
+ + groupByColumns + + + account_id,name +
+ + aggregationColumn + + + unique +
+ + aggregationType + + + count +
+ + errorThreshold + + + 0.0 +
+ 		+ + + + + + + + + + + + + + +
+ {"account_id":"ACC67262091","name":"Emiko Abernathy III","count":2} +
+ {"account_id":"ACC98264190","name":"Shirleen Weimann","count":2} +
+ {"account_id":"ACC70737722","name":"Shanelle Keebler","count":2} +
+ {"account_id":"ACC28941814","name":"Dr. Violette Green","count":2} +
+ {"account_id":"ACC42462487","name":"Marquetta Hayes","count":2} +
+
+ account_number is a primary key + + + my_csv + + + + +
+
+
+ 1000/1000 (100.00%) +
+ 		+ ✅ + + + + + + + + + +
+ + expr + + + ISNOTNULL(account_number) +
+ + errorThreshold + + + 0.0 +
+ 		+ +
+ Some names follow a different pattern + + + my_csv + + + + +
+
+
+ 985/1000 (98.50%) +
+ 		+ ✅ + + + + + + + + + +
+ + expr + + + REGEXP(name, '[A-Z][a-z]+ [A-Z][a-z]+') +
+ + errorThreshold + + + 0.3 +
+ 		+ +
+ + \ No newline at end of file diff --git a/sample/report/report_screenshot.png b/sample/report/report_screenshot.png new file mode 100644 index 0000000000000000000000000000000000000000..d82a2b2fbd7cd48b730d74feae1691a87b437a52 GIT binary patch literal 87497 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Ŭp+i+@aok8NeZchI!=OCxVLI)f@5T*)*nXKXLBczsM>a*9ybxoGruawG=-Lw3&#>qap}A z4hnx?_Mv(2$^3-bQB+-3G~9SDBs{CSlw&HN6_w4`+0yU-JFo^^$+#xKny*KJ_xH;M4n z2^*Y9z-B)>`6N6){|N^ZZtj7D?;ETe&R*?-g^fDrx<>-8EINAaH#1v8^@|}|jf{r` z!|U(E{ESy8@9#&IT@H{riTabkQg_@>T&bTTk8TO=;1^GPT&~z!oBM%tmzaowy}_1R zB>qn(LD-t?S;4nHG^fq4lJa_yVrup83KNIdj;AWl-k3$??=ZAbsZ-MNxqW?C-@s8Y z=YPmmk@!p;4U2lXVUm?1=UqpyB<^lZkph7~Chr;dkTC4fnX(Zax%7B1N0!vW{`1+v zi(grx6cH}Im9n>rj~dh{g=<(c{Nxb?kn8smX|3VVeMA&NZWZa9e2{%N_=kaG#KK?< zVOr_aq@0B8VBev2H*Z;I>ovY_$qKz4N3|bhG4I`KhYjZ79=^$$*iI0CA8|K)K6u;v zLS^9#yW{7~73WMcwCjbRyP3+`$-euuJ$MJ>JR+$Jg6#r_F?b2nt|;~p4+A7G_A%>sAI)u_KeV}jYKM%vWi$D z)o04jhtd3=_j%9EPa$6qVXL!+6u!}o4(qb3D+gXD6VKN|Slq0Tp?MRsx59QKez)1C z=*(o~{n4`JRY}JHi4R{YiIhzc?IH#Ne&O+)hmGKrg{4n0D&<5fN#BvV?LgSvGGX(^1i3AHjCIy&wEOp@o{^g4$_Qesu%=7w^O+ z!)HYVT{@h-L-p|xP&q^FL9JkJV^_e45Ge8u{O$9PVo zss4U~h||D>S1-PpGuwzpw7&8Y5V@YNp;bVNd>I4^I-YLmkZtuQyH}9TmcfBiX7v~A z%2kw&zZGQ`5ioC7qpW|;gvVu)SuHtmd4s=Gc;TcAYDmNDP=4*EGxyBAHHG5`C+zg; zmY^Wpv)YF%%+Zdk@peC|>if&kSUgPIC%Zx^Q5bIu%diPKr9%cm3vFRqoG=fGLkhyk^GL%QHCU@7D9|U8a zMoWjpSDd?=wTFiXmmfpilhCb7dg-?h@huF?^P23Foa{kjz3+dR3pb(dkwkU8X$W0? z1o-@(`$RN?1V+5tS<~0Ee*mcwCmgKWzCEWArDIQXccqFSn!@r3eI`IHx= zq^8x{plPEhgPLqT?O7(fC978|R2b!vWKst>D_QF)Ja&(SdjNFsd)S=~HUsZ}GR0%K zXUB`9_Dvx4Z5@;24$V}sr?r546^-cwy)^QNmDTqs7e5Y{ zO?wzcK;SQkb?8@(P~AFaHM)LPmApR(Dj4Z*JynF%lkPbRHfWRpnI*4p(r@Wi!qi3{ z4sCs|1F1>PG$;b^1RO~o=u60qpg5_*NlA|l}u5P&F zXBX_uRspv1RcBl5Y4PRLEHSE;GeUw;hNH>Y*m{uCtX#VrvOBz!atSmwBY`3Wb_%V7 zTO?**-Jj?-_JzH9JdYrnLovmVYdkH`ENw;<9B)98>8Fja4#K}qeJ0R&*o@fQl?w3d z;jM2CLbr3h)lZ2lutwuQcJy)G8LVqC5$`|py*07YCea_RQNd@Ti7E@&)>F)M> zw0uFs<9p44b)Y20=>`^+57(w%%XC_o_FFqOszq;UFKc++cQEE;{R9Q$e~m(%VMTIY zS-s#1b_FRjw%EPtE*s5yisaYo%%Kka!kHsf(w-iA$b)^!h`ZbVhH%(L*rU*1HJVt; zw6rMH;UdNYiPSq4tPfGY*wCOK9I{KY&)LlMvs9ijcsiNQGRIoO*?WEbnkIx=h)})A zv=)A$!4Jw#J3n11rqL#5neoIAD#oxcuIFBIz~3z(skGfHqdTjuf-Zh8ic8hR ze1adfgS+w-bdmv+u8oVoUhBKv@5kK}V7(JjD^#5us&-zFFxp(~Ouvh1HOqawIBR%! z)vCHUata8`owAKreC7TvY3aU3*t2X^yzQ{OvI{Y2KI&j4;6lHDqv4SBLTntrXR=Mz z01Hvk&D9<(!!_mxj2K+LtZfW8g(Q6CV9B?zTF9*#^Oj;>l4ci7{POy15agNtGb2Na zhp_=h_Uve+m-jI+_AALn9=v%j)w~OW{QSU;Nwpa&G}#_=q+mbm{lM0M>Y_yR1pn*= zuBeC_t9HAh^(lCfjb3e5}oi znEb3>99RLov71R)i8ow@B&Deg9SrcBTT=$H*z`9URfU^ZT_UUOLv;iVbz-4! zC~rQaX+?vzNe?R=Umwxp6M2T`_zvsv);mqvU?ez>E{+J3hbG)xMG%->T~)$IRoL?6bp{IiQbs)An72FWUnk zq;i|>g#+U4To)9k5jt`Y+qZ;vv(QX1-E(Hd8RhT=zXW3Wu?2F~6N8IO+kC{6sW!0> zd+rf2v&kJy_q65~d#nH#(K}7rG0xeljKt6#Xtx7=I@xHrzNdJp-7p)zmk_HtGY-I< z10^$N^I!-7ApA^^brYt>oST|)`U1h>h|!qyw1m2+-|<+=&;41Pgh#(S zuA(+OCGH+_vx$^87DqXA)7j`~3;K+9FVypRagO(eK8AQY;Y zrSA&bRZTd!9NF3G@uGiO@q|>Hs|;p;&!P7$h1oKT84+vO8~w2fNcax6hA7BfZf$A; zB@ZKRt|2wom(cdkc$RjLS^IMj>C-MSB*S<5x=(ZT>efMh%tcg%PL^+xsj+6T>fSj) zqp${Fd5QEP+N>msH;HcM)66ev`vuqSS8S#wA{lIY*~w#avE3b7eW^@+PNgrsewJn- zsiEKxI;9R4=s~Q2ju_1g5um@_l8Nt5v#V^~;TXYoz0dnv-dRcdN)s!xinn0adPf7# zAtL)mCZFO+%rH{S)mB&WT-z$e&M~QXZv`H%hxG`&hP~~M&)@$MEgon6$~2_*gvSrY zPku_+MPvJL7v#{Xcs%SS_>mU-o8=@sDe4I@wTo zD?pL5t0#TJL(8o#AfWsCU<)KT6S`nQ)>8qsxIHf^sj;xgB;(2yM2y_FA8CfGZYf+x zY9{XNYh@jpbY)YlzRIh^`1T>IGxPQZ=Lh?)IhrMf2_l_`{H}6Eh1qjiPbpXqr@FQ# zs%=iiR4G*7ld5*8w?20v9}L0pZB?-ytd3($D-C=g_F-Wm3CI1tzEN);o?@j2R?#BB z-yiT4!jEhBlTG!zs@oKAwnnibj@bu@$9ot3*s7q@X(siSx_-QOJ^*4)XZ$i<7T$DE z!=7$k$)xWe35Rr|dzU>wJ_%r*-^ zd!k#hn5W|&q!|CYB&9OwgKc3mJ@yefYohRz<|BWp@Kjl)F#D-Lfh-}n$d@mt7pb$H>GEWYTau2-M_xdprzp znac#h5htVTVDhsbLYKSC{Yl(hBiISI)2s7_;Mpt73FtvLG&H}wojAX8x+$hluKcT3 zPkolxW8F^Y;{(1@QVXW~Q2*C`ZbbG53{3g~Ti;fBKQq&szm>7*@=Sr0x=RvP;2)QC zw8+Y^%PuiGV5S6r<8<>2YRB&>dJPVQ0yJ|y{JFxa9qul2dxN%CZve(f!)6+GOp*r)voFt*V4gcdy;2i6U`(j;4(-WO%xdMTgm{!qKE5_Wj zfIi4z+pMaU@Uttu&hy{N;BEW&!5z$TaVMc#N3;*U?bD54L-hl(bYx&(#Hz#R8{d8W zma+M2+;bPy7f?&hJFJD@JQT<(7QIf+Nyro?b3WU-jZ=lgoUU@ujA+$7 z%ADDgkysPW6QdCokf>2fV(##0c!3zU9XbaE!V&wZaD+JZoI~o8E<>*O#0N(=*%vm5 zX%LWM)U4>BzT4OQOh|Dao-w!c5tl0I-l@Mz%%|hg_`)Z2th0u;ES1w^Kr5xdR3~or z@_6GsCB~X;Ds)uqDaEB5wrDK2Uiogg33=GIlacH^>Nu@8W)U{+ zO$Ug5dV=jvX4WWSw!2YyyzUb8YGl*zVcwlg24d-K9e9)~Y0HZCQqNrT~B?TqHckGB@I@|J;re8*Zt;gV+*m&d@;RPV8q*iF*@0B=bQ2HZI2QXy)t)~{MO(j$y8_n zJ#x=`c)XH*)&xDrEmcnNtbWq^NEp&_avsdI{4`%bvu=@m1JcM>xKwvgrqnKUO3rW6 zs(cRv+QkGSpN8#*2zR(f&>5I}OiDZqEa6HS$$^?$GV)%;WFzb>R*{>+J{7Lq#h0^a zp7y)1=4<%fXzrd2A|J7-3Y{+fa$RuFy30a#pTrb-OthHEl#sc!wNF$mElq#ARpK3L zeH6FysW*01-(AiArSLV!%hQ%hagjvms(3%>f_&b>W_aS`d-$`hkQYdHSklT3)F9x+kA*K1}W&q(DB(`1P{O z`d#YCfQ{2~V?gTb41q_>)-aLu1`8I$m$#$(tKQ*z9*g*AOA&?ea&||u#uv=uIwqDB zYLLxNr|G6Z#FxO5u5F>l62Y2w>~e?5*K%_D?#eeLCap%DQy0o1+13wYq_4OGa9L z4L$twl70?N;GG;_I?$EsVVre?mG9T#5~A4*iB!FZr443uz%kRI6W7JwZ}h$u8%u*q zLiLuPk9Ho$WkL8|QG|=`=4TaK1^P`Jql3V;FD#84Eb-*Jqg$lpFxRMOgMft1`^GRo zih&9~9n7uUFHtMxMVLpod5F9#99l&1`9U;`hmzjrz9kaak2Ys)cMX1g^kPjWC#Ew?4G^pH~;~c;KS7uIvbK%STY0WweDiGjZ$vD^=~))5=a%#fHB(K zrSrsM%{m?$zGQxrHITHnCMa~m_3Z_%LK+X`@>KTrw9=HI%x9Uy7IoZ?Hc(Gy-S@&| zyGOr!=(vWPJ@st(a06?b(qDtonW~28Lg$Mun$}J6PmXtYMvNWX7RBZJM2_p-Aunj# z$@J?P>ec%Rso_bOx^<>+Ya=s`cUJY47~ zvqDuEH_zYorvB<-+S=WDHu;RE1jA)%?3tO)l2Jie57x^c$o^}O)PDp5kmlrSjO-TL zc>)<-!}?{r74|BHp2FtY6Q3Sr1ZMVsXulcW(so=#XVk@U!>r-?JPvpwggq8PmZ7;E zgoXY;{mN(EicG%;hy<^{I<7{fEU6^C6I>ah-lO(6wxR#(=#s;0j`>}J?bXZgq|d0C z3LKsp;wki8TVjwU%Y;7H{SA^r+BMPjR+g_)<=M-HDm7l7_JQ)<3R&qJSt=GDFJ;3j zFrMIgb(CZd@$h(O_?KjClc+@uQCWttqwg;hGdZrXC8#r|)FsmXC{_`i2so5!k7|%( zx0oaB+nK|M;|IBgNhQCq;vK#ns(Fix*>v63M8c?h4d>0F9-FtQ_Q+;pS7)F4n*UDJ z=%zj+0soKb6nq5l76N^vSn!?1YfSY?NHWbdFTf4S*tcounMVlx8>%c>6&u!_!_bq7 zptFj;&gq-4zERpvgf<8!(J$~P3lhP$y|}xYy%Q%c{}brF)iFX?nr*i296#Wh^x01Y zXp~DY@bP?$?vXv=`Lg(jygRO&ebc(EyE`pY%z?_buTLF{e)Lr2HMkkx{=7;m2Z1}s z68{11qsLsYlxl)iywkS$7P&xhOD<@@2=}wr_U6g%C)1GA`}Q_udJk6YID*5wS1j{C zJ+tvsH))PGWIN_Foi=oAy(~ZZJ{Z$GOBgkZwqNmNSs$BxhV~hSW(_+=tfW5zR4P#_fEIcX?|dmZMfa}*RxPg@8_v3 zo%F*7QzJ{O=~{D9MSsd55w}=hn(x<8%!6)yDGoOFfXA7%ShI3|et~xzlIiLBNof;? zB&HjJU0OPomr?PydJ6V~#WMf1scj32K8catJ~;^hwGju#2V$x-`YWh9qvdIF;3k8x zV8;C+Seq6WYwWu6Gh2+YM!}tQ{Bdju3Fp{`r#5@~VrB%D1@6Rxq!cseU-g zpB(h&A6Z=>T3q}ZB@XBOa)&x^n_Eg*!i&hCcj;LiRy~$ubc~>k+sYe3@=e z#QSop>$I4{y_fIk=l4Cq#dgFUD-k?*UKXg@j-K!d5L{7YSA0kEho$mbS|HX*m!=`D zPdY`l!?vd)Y!A=9dP)!%s%p{JyjVvzF=+*GyEsZrjpnPD*JHjFz2Q0guw=lJS<~zL z_HU)i9Y=dI0h`Q*n8WMu>qf*V%HRAU2m0^Bt_AcJ(NY@IqRT=9uCotaWjxvTpf;R1 z*Aw+iWUh}Kmt@^dCz%^A!xZBGa#P?I=nOdG1sYM}CbRgvGWhL5d|YJaj4)c8?TtA} zew?x499N@#ast``ZWETAi*U8;?!Qviu>!Yci<+*C?SA+R%X(_jkd;Q1RE}7LW(i7) zZ4$Qjl+^&g3w^#DZfy&Hq3FCHvNp9HQw=DyQn$O*_!4lm(x`c&_sPYR^=2mfCw2l6 z?jN$mYbzhs%^HsFEGZAVE$~u3igHsf9$fgj1&BxsIy*c!9OWeo1B(Nu(9qQhOxxU7 znpXf!P}=zwvSO$ahnn|1$FJvqYH(Dq;k9(xN~db4bfbhKW8V$D1Ty>X(2pWBI0x)3 zy=%+6lywU9t~jUHs#A3a$y&+<8Ik8^>nB%|H%fEjAa|p=#J06h|5!bFh#D~2DCgK^ zTtBt}BZ8EW>A!;}D-etx@S%=T{k8vcNgJSH{h+Ix6nLV)-(1KBYY0w|kF40Gn2YCc z_4rfOc5QXX%5ugd{dJW!@yw_NWp~N+HI+xw{g)_)*2xLES( zUs0!WGOx~}RCh3WeYH^Jobl=#W}s{J$Ue~=v&iGQ8B&@I{`4!h)r4afJ!qb6CihJo z1aP}DpV-VdcQcaR@as?E)g6bQaOyx@Fuh`I()QYuvTN7T0S-vh#^Q3}sd&gnGKRIy z3aKcpW3P6y%!$t$-s$FDF&Ig1RxjLK*vr>i*Y4bxljZGsd5HVR_LCl5Bcb1DS+^Q% z{1xcQ`zlHY{__6bJdfFj78XqL2ZsofUXdQj*MzJbfNE_Q+V%mGcB9pjnimnXqF^tp zBE`RzE1A9InDi!OdCHVL@sG=NAP3QVu^>dXU&NCsZ}mju69=~0gW8G*XIsO;k@iA9 zY6kWL1{aq_KG%C2!I7EEyDNX{Uotyu_O!mgQy4JFVkBs>W$-hT6TYxN*m2>|043-2 zO#!AjK+N9Hqi&s5|8)5~O!~gDsEMPc{LYhTO=dTk>~$!2$7hiH>v%fgZGk{Z#&Kl{ z_QwpM$^Ol6x3FurKoLSj7&EKX1-IC>_(2T!PH2b8dRr4mh210ky)=F6)a&H`ldU@B z#N7DwO@`do!|64$mbWj?rkJ);1oZeg3|+*2O}5*cEXr#(#HBac|0{oG(CW1Zofwfa zsa>Tl|75iLI{)Fj&jk=p%b}8!aoRQIn~V zJ8SD>0iZP3iRM}dMxaV zXQTgT*gH-{d5%e^aXXVeZ!NuDv0Rs>!c$!@)B^68EWG5uY%0aRwG(OAO=--62IQ7go@(^0ogD8H*S`6dS`t)K1SI zEXf|M!Ui=*vZ^)hPxtvpFJG4^c*8{2;}s@{b^p-U$U|-T7$)d8i@rT_O~IHSaWOu; z9nMiJ9ZH=JsDZy?n6X+JpB0fv&ma2tdU^dY&sR1kIJDvj^(7S{r{7dSc?MXIPpuuF zs1ud?2y^^MZC{R2q{%P;LrRnHO=E`BSG5|wiejyuc60qYz|Xg;BP9Itklfln;m&PL zv&0$z{vV>|)l!{OUn!+ctF+K;E3kE7?PNYbK6t3F-Rjz6YX(P3$n%0UQN(N3q zWOHhJP7qm!U833gKclz*?vv0ffQJsqyK7#kPcPaSb{%~RzvIOcpWXSH;Vh6;7)n+M zz-?yi@BT*vP$q#m9!3TR*%plQ>HNq=nHlf{v|yB|?>7sOFZRc!=Hu#$BJ9Ma#s9hU z|DU!}^ljlIzWD){o_YlfPxnhB#?vni^Jw15$?5&$ntiSP8&o*{eYyj|NA*X1UFuab zpev=tgR0((*AY!>=DQv-&jX*5r_l<7_<2(ktXUX~O@L6bbA2y0B$k$WD{)!Kk8=P5uk3qMP z8|E^&yRgBE9&*A9etjH#ARLD%IA|e{s6aLxxVwYyDh`l0u=5?zJDK}}p%3Enr{B!HO?De_63B*p51{qGm!SP#oRJ@0kSZWR z07p1SN`!{EGxCvHw;8VmB0z9h%=;ThFitQDmp%}N9tuGe|BvQ2uw?8Mh zXljgMwGzBtAai}H9t_XCujG*2hOUwZ1wQL&Q-ldWy3bT?>-2dNvq>n3*sgIc2xzB| z;ZL!%ty}DalY1g};eOWGwj!+J7~Tg6Od$Q9yuj__t(DD-!F)C~i*9YgOMK4CY*aFd zz)<>nP}$}M-}6NF3DKRXA^^%cI;KF~3h)l|=FQ9BqKOeru(CB5B^PJ$1|F3kevR<- z#Sh8HMmBfNT(oQLrRg6nrdc@}w6l3_<5i04Bhx-u?zlDs>9W z*jz1VT=gcjKeyrG|=aQj+Bq2OTeos$2` z4G5BG{V+ZPrpG6Eebsfht;21gD5oEG$-d~&g~i>fy%-1gk`Nd`GwJral) z1kiGnlvWB4u=InvMLBCNt~5S9u=s>S~@Ui8TZ{hpZoxzarW^DC2MOfU3~)a!ae@|;}y=cd5Q`E4xhPSJ)$ zqLb|M8uT!l8C`G2@T=TxPOCl zlAwsz)g|uUJ-DOCJqCB+Z_LY_Qz|Y4Pib@eedB~X-SPd@)f{tD0l)GNZFU#Ki&u%O zDHZRe9duolDHMK5ETLf0nEHcfUeV6lFY^<#v;$O$#`o2-r1z{5T1pO%~}ge_n1gP81q7Dmk@c0_Ej%&-yr_+UvEsj z8C_@gP7cj++D?pi!~~1(dc)cmT*9kfP`{=^Jg++*JD!u=@;>Do^v{nf4#8n|npcs? zdRzA6d=%tgVI~D0-mUrV$(**YO zz<+B2+G#d-nYOr`vP(qk#U;BHx@OO6$BnPF7D_HsjHYRMw=9V%I?CMJ)W~fWEvlKh z+yNa%-b~XbLJtlU@Ybpu3M+5J;9}Z}v0?Bw4dSsYZuTf`utno|0-ICsgSe$L%@pYL zYf+2Fmb#C&iF-A=Nu2=(FF*OaLv$0J)xqf_ z7-o&%-vH%4C>u{fN1*4+YN?gE=62eshF`Z68u@hrzckI6nhF&?TrrL7k6Ev=w@&G6 z{KT+GBCody8zRAEhR^q7S257BYFEULD+!)7PR{~WuU91yiBFaV7gKr^J63i-K9|z7 z8n9dMDzaTdV?Jm|>o?v` zyb_Jq@D%2!aE;H%-M|NRv%z=uF*p7SzVhNY%u+ZO^tVIw80A+cNCxGv#HBfc-?!Fp zRO6PwEGtNHU{`qd%71f9AER(0ZpW)9jbFV<6zVW~Uih>omgvBQ-0n&O zt#y3Fng7?@aS~+IZfK{=ylTRaum0TKkxie?;N#vgBMz@Hm?PiH!$@Fn&t42SM5{s< z*-opkgp0(9;W?{kyl0Bis&tL=7Zs`C8hcG&=CRfR5&2In(W}g>*UD@Cj5om8|1%O9 zfaZ5tn$E=;nR?3p$)*P0%K{bh0u}9-+y}vf7Q7l7*{}z7q_u?;cM`2 zD2ljIs9BzKdbyI7WbF!`%xhq@t(J*-{LVs-i+U zBk>A;;yXOc%=abHcc@tAb4|-2sJr=bstMWDqK>|_E`g%cJ@xg#D^BfA& zF!cd|2_FFEglL5plEOVAc!T4{N!qO`(5Sl{XQ2IPc>~4~oK5~j*zMVH;j%Z-o=+s8 z;y9q@s6FqSHQ?dWs3M*=*}c;N8|qPvXso_`g*>YGd6oqu+n@81esU+O@=*ghWTc~`N#vuLt2s?7;#7!8XwXCoyg4DmC#!Nidmt&#{h?_?he&OGnS zG}ZrJzLp_$zDTjeO?krOd=vd(BRB%}@k9MVvP^Op>~lTyBqA8ln8^91kx!3F{_Qzg z*{Ll)VQ|hbt&hb^Z=JbACswMcTz!72(s0_8-FI?Y=ixEeA~UeVO_#%^F0ep8LPR4Y%D8 zP$_|*^EIS}+;?QL1%ns*B?QHZFLX4JrfxH9p|BvO99Ed1 zB*5S#RSazppIGDI2Q)I}7N|}m{%|Li9OvmKxt@E1T?J|JyyII?E% zihQh9YniTy-saG&`}cBcnFTGUPYZrRg{PlWUF7po9Xw5v(|*&!Z}jc(2&JX!bY9#o zRCuW${Ut2g7mC9wBE0tOb4z>Is#F&p3m?&p0PK)R85UBe-iEE$Z8LSB3L`$*87%>0}vNHKJa4 zc+StP7$`K;q@GfjN|>%|9j&KSl94+h?_BwO{q1*+`j4vB4*wk$o`%yG`xb>|H~KbV zW%*{BeC|GPiT>Nj^X#X$o|PilgfucaI_m*nbqR8fk$;%A)KS$X?=E!vut^q5)G!j_ zUF0)9a`D4pdkOhgqjwiB0)UTc%?dS%Fh1Qf_xJyUm-=H?J@GYTk878%NW#vitKA9v z$f93{z5@CM3wTp?JQ4*nWq!(Evi{S5GQM(s=RCsXmMf32csh6RnP&Ifxhq4*iY!ib zayFGC^}#5@Z2W)m)wdp0?mPD##cr*a5n;}>a+6=?k{=$!R^a*sS*yD?W|6L|8A|tz zEVBMrjn^_Y?Y1o$8{Qm;EQ(Zmv3Up3hS%GZ8CXr(nuOq>JZ{B0nXEx+RRMX;8swkp zUhEyBvOixw?B4!k4%3WbPuUYxF=QFp7Z9F+mBHS};G-j5oc>sMyY*vK3j7awl;+at zb~Q)kQU~^#P(|=3YCRL9=J=>D`r~P6#{`Z_wm|o1Ykbmm=c-#i#dXF1-Xm)pKUQ-t zH0tR5Ix{crlnzY#&TLx96G!V1N>?%^X@I&z@$}Q=$AbTq*^5$Hxq85IGW-81d+UIv z-uDeyMMR}UB$N(8TDqB%($Wpm-JL^PX%K0KQqq#6ySp1k4Wv8Aws#nx-}n9Reb3)J z_qpS`uID-1v-?JM5#ZlSN%J%%T!VRh^rD%2ImVZiY??g>W7+T2SA+d-c2-iCSZ+Jv z2p58_js1LmTX*{uv?E`R7vaq>VokTNcv)y9G)=9?9#_Y6Y4XF55k#L|?bdShfmT_O#rd9n}e zX_6I)^1ev_PX#NuNCc{P_&#<|uV_zZTXP({rNDA_aDiL$sMBUUUp4ntca^ICm5w2s z>!D5A>sRz8D|AA01$|s=?OR7U>RsPhXi-(uz@)DG!T!Sp1rESRunwOHDAxU=YVFd; zh@x+_=)l9rzMFD@ut0r`d#~n|{s;*Lr3iq`_N_!Vew@|j^ODwamyPDYJ$BI#k~s(@ zt`Ek{^wRclW$D2_*kIlSiF_1gFz5SOIPWa7X=Yx-Jhj2Q5vM9xgtU3My-@bfJX0X* zffKS?FT9#IXR3EbWWL$F)TWks03#`WuM>fIx-YodNu#0OtFaR#CB}!6AUp`|l5(?_lTpwOmiU$POu0CL1 zzJ!CWr&B|3SQqw4L(KU^kiHcBhZO`VXZIk3^B?tk39pOAVHKn79X>Ql`_VlG59$c* z@ugQiwHVGn-McV~6~wG@h(p&6T(X#8#qk~YfED;T7b?}~l9XPEC=jULTp`dzI5?bo z+&=`y2)?ITjIY{Dh$$LsU1H|`SYn3>Dm7{n;V56&y;z>pv^?Rjo#&GzoH2iW zG$i78Wm|j{vJHtsX(e@Fe0^1Zw~1|*zE0N>ypt7JB?H2#m^evqF!r`1{%U&nI``Zs zk3po$GgCvv3r9n?gr8G)8_=H0l`yBl|8RNi}6 zpxO64<*L^Dta`sjCp3N7>SpYh{IKP^ibFt*rzS<=B%#$|p72a6(Ln(3LbC}-+&sfA zp4%VyPV}P&dI9e!z?(+(#o*cpx^Zm5tzGBqtVJuAj8Nn{TSzY*?#wv+FkNzEnWOfh z@dZ@S8~t3QrJt>OMZZym2a`ncLy4eYlcNtXR?1#%>t&yNijxh!!=8-C$I^D;i6&ZJ zL!JR6L4M6yCbq*q&S6vnR0Uy_qpagDd~qIPL$FxW7+sM}xW8D0x7JTE**_wVZ03TJMky)w+?dKAAGNWEP0D|&g~}HG~_#b+2LekVl}(` zFlPYe`d;PykL=9AE=}uMOWUGI+b-+P@l@{KC*8fvrtJz{QTX&-R2cFK0!5>MpLsLH z95L})ba}7WIlB1=nZ0M%rli2kyjWOQ{;bE(sA=H~d&*UFifVdl2Zu_4sb&Q~9baO^ zG_>E=uO>0_)$%dtybmY)RKW0ydZytOFUZ52Wy+31j`ypbL33cep%KLB8Hi4X~(IHHvCPKmMa)231sHcR%i&i1(ULc=f=abK$NeUp!-_V^*Z5$vulMwZC3;OZx;ALyM3 zD&90N8EU@oj-kGFal)zdK5j8`zM<9oAvlY0A4@mejAWNXH-~q5Fi#a|dAe3QMYhSJ z+m_17wBzu)qVV4SM#$U^$j?RtOt9MzHXjSo|Y7$B^}M? zgN;#3V$a~R*AMSaAL&W0x05N_7{rSG7_jiSpD^LcH*_IqJjggs6{VnvE?FsHHLau5 zuCZS^B+ym8>kjh6kOGE)4XRSGu^|wc_jK?BsMHAJTI6tq|E>YVKUlcN#s2P8bY|^h zNF>W8z8cHI)b_#3;Da0YWQ>Jg9^Ga%3_9GJF6^t|tMUA1t~!C-#il!$Ksc}51td_% zTmBNpcDP(CfEje~X6O8+g#xRXchjStN^D$EkN>>AzGd6~-QE1?Hq9OAk`Qt=_^dR( z(7Hyi>CPTd&mVRwuv>DEYa$u$ad#gQQje9Q2x$wi{|Re=J8fTj7{i+a-3?Hq^++)> zGY-7$zO}R&O)A(Je0rdx^;O1)Qp|&^9ju{G8uh?9R<&M_z%C&ex6R#XxyRG^;H4Z` zhvX-vc8v*8}4t7EY~#O8s#=UY2H;i zl-|`nI7kmU$GZ`?Z+cLJ8oz6bd2u*i(99(O$fegCXt!MgiqqTQ74lC{WvM9{3J|)u z+2#VQN(GfvXP(8pP`n!E${RcxQT(;Z_U(+Ku8Y@OSQ2t`r&tiX$e>X-N_qdd6EuGZ zT(F^p?^p8>`}@#tpC@9KPT1zHGf2M{60nu<>o)Gfa6oYx+u2#L!g~jy?jy|-%~HB* z18ThUU66$Z2QO-X~&zSdVb`s{+-Z+~V}v&W;71wCr#=fZbe`f5

M7?PuQXAqhEA+oDduAMjII%#3 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 SW$7vgAn Try now

Data testing is difficult and fragmented
  • Data being sent via messages, HTTP requests or files and getting stored in databases, file systems, etc.
  • Maintaining and updating tests with the latest schemas and business definitions
  • Different testing tools for services, jobs or data sources
  • Complex relationships between datasets and fields
  • Different scenarios, permutations, combinations and edge cases to cover
Current solutions only cover half the story
  • Specific testing frameworks that support one or limited number of data sources or transport protocols
  • Under utilizing metadata from data catalogs or metadata discovery services
  • Testing teams having difficulties understanding when failures occur
  • Integration tests relying on external teams/services
  • Manually generating data, or worse, copying/masking production data into lower environments
  • Observability pushes towards being reactive rather than proactive

Try now

What you need is a reliable tool that can handle changes to your data landscape

With Data Caterer, you get:

  • Ability to connect to any type of data source: files, SQL or no-SQL databases, messaging systems, HTTP
  • Discover metadata from your existing infrastructure and services
  • Gain confidence that bugs do not propagate to production
  • Be proactive in ensuring changes do not affect other data producers or consumers
  • Configurability to run the way you want

Try now

"},{"location":"#tech-summary","title":"Tech Summary","text":"

Use the Java, Scala API, or YAML files to help with setup or customisation that are all run via a Docker image. Want to get into details? Checkout the setup pages here to get code examples and guides that will take you through scenarios and data sources.

Main features include:

  • Metadata discovery
  • Batch and event data generation
  • Maintain referential integrity across any dataset
  • Create custom data generation scenarios
  • Clean up generated data
  • Validate data
  • Suggest data validations

Check other run configurations here.

"},{"location":"#what-is-it","title":"What is it","text":"

  • Data generation and testing tool

    Generate production like data to be consumed and validated.

  • Designed for any data source

    We aim to support pushing data to any data source, in any format.

  • Low/no code solution

    Can use the tool via either Scala, Java or YAML. Connect to data or metadata sources to generate data and validate.

  • Developer productivity tool

    If you are a new developer or seasoned veteran, cut down on your feedback loop when developing with data.

"},{"location":"#what-it-is-not","title":"What it is not","text":"

  • Metadata storage/platform

    You could store and use metadata within the data generation/validation tasks but is not the recommended approach. Rather, this metadata should be gathered from existing services who handle metadata on behalf of Data Caterer.

  • Data contract

    The focus of Data Caterer is on the data generation and testing, which can include details about how the data looks like and how it behaves. But it does not encompass all the additional metadata that comes with a data contract such as SLAs, security, etc.

  • Metrics from load testing

    Although millions of records can be generated, there are limited capabilities in terms of metric capturing.

Try now

Data Catering vs Other tools vs In-house

Data Catering Other tools In-house Data flow Batch and events generation with validation Batch generation only or validation only Depends on architecture and design Time to results 1 day 1+ month to integrate, deploy and onboard 1+ month to build and deploy Solution Connect with your existing data ecosystem, automatic generation and validation Manual UI data entry or via SDK Depends on engineer(s) building it

"},{"location":"about/","title":"About","text":"

Hi, my name is Peter. I am a independent Software Developer, mainly focussing on data related services. My experience can be found on my LinkedIn.

I have created Data Caterer to help serve individuals and companies with data generation and data testing. It is a complex area that has many edge cases or intricacies that are hard to summarise or turn into something actionable and repeatable. Through the use of metadata, Data Caterer can help simplify your data testing, simulating production environment data, aid in data debugging, or whatever your data use case may be.

Given that it is going to save you and your team time and money, please help in considering financial support. This will help the product grow into a sustainable and feature-full service.

"},{"location":"about/#contact","title":"Contact","text":"

Please contact Peter Flook via Slack or via email peter.flook@data.catering if you have any questions or queries.

"},{"location":"about/#terms-of-service","title":"Terms of service","text":"

Terms of service can be found here.

"},{"location":"about/#privacy-policy","title":"Privacy policy","text":"

Privacy policy can be found here.

"},{"location":"pricing/","title":"Pricing","text":"

To have access to the paid features of Data Caterer, you can subscribe according to your situation. You will not be charged by usage. As you continue to subscribe, you will have access to the latest version of Data Caterer as new bug fixes and features get published.

"},{"location":"pricing/#paid-features","title":"Paid Features","text":"
  • Metadata discovery
  • All data sources (see here for all data sources)
  • Batch and Event generation
  • Auto generation from data connections or metadata sources
  • Suggest data validations
  • Clean up generated data
  • Run as many times as you want, not charged by usage
"},{"location":"pricing/#pricing-table","title":"Pricing Table","text":""},{"location":"pricing/#manage-subscription","title":"Manage Subscription","text":"

Manage via this link

"},{"location":"pricing/#contact","title":"Contact","text":"

Please contact Peter Flook via Slack or via email peter.flook@data.catering if you have any questions or queries.

"},{"location":"get-started/docker/","title":"Run Data Caterer","text":""},{"location":"get-started/docker/#quick-start","title":"Quick start","text":"

Ensure you have docker installed and running.

git clone git@github.com:pflooky/data-caterer-example.git\ncd data-caterer-example && ./run.sh\n#check results under docker/sample/report/index.html folder\n
"},{"location":"get-started/docker/#report","title":"Report","text":"

Check the report generated under docker/data/custom/report/index.html.

Sample report can also be seen here

"},{"location":"get-started/docker/#paid-version-trial","title":"Paid Version Trial","text":"

30 day trial of the paid version can be accessed via these steps:

  1. Join the Slack Data Catering Slack group here
  2. Get an API_KEY by using slash command /token in the Slack group (will only be visible to you)
  3. git clone git@github.com:pflooky/data-caterer-example.git\ncd data-caterer-example && export DATA_CATERING_API_KEY=<insert api key>\n./run.sh\n

If you want to check how long your trial has left, you can check back in the Slack group or type /token again.

"},{"location":"get-started/docker/#guided-tour","title":"Guided tour","text":"

Check out the starter guide here that will take your through step by step. You can also check the other guides here to see the other possibilities of what Data Caterer can achieve for you.

"},{"location":"legal/privacy-policy/","title":"Privacy Policy","text":"

Last updated September 25, 2023

"},{"location":"legal/privacy-policy/#data-caterer-policy-on-privacy-of-customer-personal-information","title":"Data Caterer Policy on Privacy of Customer Personal Information","text":"

Peter John Flook is committed to protecting the privacy and security of your personal information obtained by reason of your use of Data Caterer. This policy explains the types of customer personal information we collect, how it is used, and the steps we take to ensure your personal information is handled appropriately.

"},{"location":"legal/privacy-policy/#who-is-peter-john-flook","title":"Who is Peter John Flook?","text":"

For purposes of this Privacy Policy, \u201cPeter John Flook\u201d means Peter John Flook, the company developing and providing Data Caterer and related websites and services.

"},{"location":"legal/privacy-policy/#what-is-personal-information","title":"What is personal information?","text":"

Personal information is information that refers to an individual specifically and is recorded in any form. Personal information includes such things as age, income, date of birth, ethnic origin and credit records. Information about individuals contained in the following documents is not considered personal information:

  • public telephone directories, where the subscriber can refuse to be listed
  • professional and business directories available to the public
  • public registries and court records
  • other publicly available printed and electronic publications
"},{"location":"legal/privacy-policy/#we-are-accountable-to-you","title":"We are accountable to you","text":"

Peter John Flook is responsible for all personal information under its control. Our team is accountable for compliance with these privacy and security principles.

"},{"location":"legal/privacy-policy/#we-let-you-know-why-we-collect-and-use-your-personal-information-and-get-your-consent","title":"We let you know why we collect and use your personal information and get your consent","text":"

Peter John Flook identifies the purpose for which your personal information is collected and will be used or disclosed. If that purpose is not listed below we will do this before or at the time the information is actually being collected. You will be deemed to consent to our use of your personal information for the purpose of:

  • communicating with you generally
  • processing your purchases
  • processing and keeping track of transactions and reporting back to you
  • protecting against fraud or error
  • providing product and services requested by you
  • recommending products and services that Peter John Flook believes will be of interest and provide value to you
  • fulfilling any other purpose that would be reasonably apparent to the average person at the time we collect it from you

Otherwise, Peter John Flook will obtain your express consent (by verbal, written or electronic agreement) to collect, use or disclose your personal information. You can change your consent preferences at any time by contacting Peter John Flook (please refer to the \u201cHow to contact us\u201d section below).

"},{"location":"legal/privacy-policy/#we-limit-collection-of-your-personal-information","title":"We limit collection of your personal information","text":"

Peter John Flook collects only the information required to provide products and services to you. Peter John Flook will collect personal information only by clear, fair and lawful means.

We receive and store any information you enter on our website or give us in any other way. You can choose not to provide certain information, but then you might not be able to take advantage of many of our features.

Peter John Flook does not receive or store personal content saved to your local device while using Data Caterer.

We also receive and store certain types of information whenever you interact with us.

"},{"location":"legal/privacy-policy/#information-provided-to-stripe","title":"Information provided to Stripe","text":"

All purchases that are made through this site are processed securely and externally by Stripe. Unless you expressly consent otherwise, we do not see or have access to any personal information that you may provide to Stripe, other than information that is required in order to process your order and deliver your purchased items to you (eg, your name, email address and billing/postal address).

"},{"location":"legal/privacy-policy/#we-limit-disclosure-and-retention-of-your-personal-information","title":"We limit disclosure and retention of your personal information","text":"

Peter John Flook does not disclose personal information to any organization or person for any reason except the following:

We employ other companies and individuals to perform functions on our behalf. Examples include fulfilling orders, delivering packages, sending postal mail and e-mail, removing repetitive information from customer lists, analyzing data, providing marketing assistance, processing credit card payments, and providing customer service. They have access to personal information needed to perform their functions, but may not use it for other purposes. We may use service providers located outside of Australia, and, if applicable, your personal information may be processed and stored in other countries and therefore may be subject to disclosure under the laws of those countries. As we continue to develop our business, we might sell or buy stores, subsidiaries, or business units. In such transactions, customer information generally is one of the transferred business assets but remains subject to the promises made in any pre-existing Privacy Notice (unless, of course, the customer consents otherwise). Also, in the unlikely event that Peter John Flook or substantially all of its assets are acquired, customer information of course will be one of the transferred assets. You are deemed to consent to disclosure of your personal information for those purposes. If your personal information is shared with third parties, those third parties are bound by appropriate agreements with Peter John Flook to secure and protect the confidentiality of your personal information.

Peter John Flook retains your personal information only as long as it is required for our business relationship or as required by federal and provincial laws.

"},{"location":"legal/privacy-policy/#we-keep-your-personal-information-up-to-date-and-accurate","title":"We keep your personal information up to date and accurate","text":"

Peter John Flook keeps your personal information up to date, accurate and relevant for its intended use.

You may request access to the personal information we have on record in order to review and amend the information, as appropriate. In circumstances where your personal information has been provided by a third party, we will refer you to that party (e.g. credit bureaus). To access your personal information, refer to the \u201cHow to contact us\u201d section below.

"},{"location":"legal/privacy-policy/#the-security-of-your-personal-information-is-a-priority-for-peter-john-flook","title":"The security of your personal information is a priority for Peter John Flook","text":"

We take steps to safeguard your personal information, regardless of the format in which it is held, including:

physical security measures such as restricted access facilities and locked filing cabinets electronic security measures for computerized personal information such as password protection, database encryption and personal identification numbers. We work to protect the security of your information during transmission by using \u201cTransport Layer Security\u201d (TLS) protocol. organizational processes such as limiting access to your personal information to a selected group of individuals contractual obligations with third parties who need access to your personal information requiring them to protect and secure your personal information It\u2019s important for you to protect against unauthorized access to your password and your computer. Be sure to sign off when you\u2019ve finished using any shared computer.

"},{"location":"legal/privacy-policy/#what-about-third-party-advertisers-and-links-to-other-websites","title":"What About Third-Party Advertisers and Links to Other Websites?","text":"

Our site may include third-party advertising and links to other websites. We do not provide any personally identifiable customer information to these advertisers or third-party websites.

These third-party websites and advertisers, or Internet advertising companies working on their behalf, sometimes use technology to send (or \u201cserve\u201d) the advertisements that appear on our website directly to your browser. They automatically receive your IP address when this happens. They may also use cookies, JavaScript, web beacons (also known as action tags or single-pixel gifs), and other technologies to measure the effectiveness of their ads and to personalize advertising content. We do not have access to or control over cookies or other features that they may use, and the information practices of these advertisers and third-party websites are not covered by this Privacy Notice. Please contact them directly for more information about their privacy practices. In addition, the Network Advertising Initiative offers useful information about Internet advertising companies (also called \u201cad networks\u201d or \u201cnetwork advertisers\u201d), including information about how to opt-out of their information collection. You can access the Network Advertising Initiative at http://www.networkadvertising.org.

"},{"location":"legal/privacy-policy/#redirection-to-stripe","title":"Redirection to Stripe","text":"

In particular, when you submit an order to us, you may be automatically redirected to Stripe in order to complete the required payment. The payment page that is provided by Stripe is not part of this site. As noted above, we are not privy to any of the bank account, credit card or other personal information that you may provide to Stripe, other than information that is required in order to process your order and deliver your purchased items to you (eg, your name, email address and billing/postal address). We recommend that you refer to Stripe\u2019s privacy statement if you would like more information about how Stripe collects and handles your personal information.

"},{"location":"legal/privacy-policy/#we-are-open-about-our-privacy-and-security-policy","title":"We are open about our privacy and security policy","text":"

We are committed to providing you with understandable and easily available information about our policy and practices related to management of your personal information. This policy and any related information is available at all times on our website, https://data.catering/about/ under Privacy or on request. To contact us, refer to the \u201cHow to contact us\u201d section below.

"},{"location":"legal/privacy-policy/#we-provide-access-to-your-personal-information-stored-by-peter-john-flook","title":"We provide access to your personal information stored by Peter John Flook","text":"

You can request access to your personal information stored by Peter John Flook. To contact us, refer to the \u201cHow to contact us\u201d section below. Upon receiving such a request, Peter John Flook will:

inform you about what type of personal information we have on record or in our control, how it is used and to whom it may have been disclosed provide you with access to your information so you can review and verify the accuracy and completeness and request changes to the information make any necessary updates to your personal information We respond to your questions, concerns and complaints about privacy Peter John Flook responds in a timely manner to your questions, concerns and complaints about the privacy of your personal information and our privacy policies and procedures.

"},{"location":"legal/privacy-policy/#how-to-contact-us","title":"How to contact us","text":"
  • by email at peter.flook@data.catering

Our business changes constantly, and this privacy notice will change also. We may e-mail periodic reminders of our notices and conditions, unless you have instructed us not to, but you should check our website frequently to see recent changes. We are, however, committed to protecting your information and will never materially change our policies and practices to make them less protective of customer information collected in the past without the consent of affected customers.

"},{"location":"legal/terms-of-service/","title":"Terms and Conditions","text":"

Last updated: September 25, 2023

Please read these terms and conditions carefully before using Our Service.

"},{"location":"legal/terms-of-service/#interpretation-and-definitions","title":"Interpretation and Definitions","text":""},{"location":"legal/terms-of-service/#interpretation","title":"Interpretation","text":"

The words of which the initial letter is capitalized have meanings defined under the following conditions. The following definitions shall have the same meaning regardless of whether they appear in singular or in plural.

"},{"location":"legal/terms-of-service/#definitions","title":"Definitions","text":"

For the purposes of these Terms and Conditions:

  • Application means the software program provided by the Company downloaded by You on any electronic device, named Data Caterer
  • Application Store means the digital distribution service operated and developed by Docker Inc. (\u201cDocker\u201d) in which the Application has been downloaded.
  • Affiliate means an entity that controls, is controlled by or is under common control with a party, where \"control\" means ownership of 50% or more of the shares, equity interest or other securities entitled to vote for election of directors or other managing authority.
  • Country refers to: New South Wales, Australia
  • Company (referred to as either \"the Company\", \"We\", \"Us\" or \"Our\" in this Agreement) refers to Peter John Flook ( ABN: 65153160916), 30 Anne William Drive, West Pennant Hills, 2125, NSW, Australia.
  • Device means any device that can access the Service such as a computer, a cellphone or a digital tablet.
  • Service refers to the Application.
  • Terms and Conditions (also referred as \"Terms\") mean these Terms and Conditions that form the entire agreement between You and the Company regarding the use of the Service.
  • Third-party Social Media Service means any services or content (including data, information, products or services) provided by a third party that may be displayed, included or made available by the Service.
  • You means the individual accessing or using the Service, or the company, or other legal entity on behalf of which such individual is accessing or using the Service, as applicable.
"},{"location":"legal/terms-of-service/#acknowledgment","title":"Acknowledgment","text":"

These are the Terms and Conditions governing the use of this Service and the agreement that operates between You and the Company. These Terms and Conditions set out the rights and obligations of all users regarding the use of the Service.

Your access to and use of the Service is conditioned on Your acceptance of and compliance with these Terms and Conditions. These Terms and Conditions apply to all visitors, users and others who access or use the Service.

By accessing or using the Service You agree to be bound by these Terms and Conditions. If You disagree with any part of these Terms and Conditions then You may not access the Service.

You represent that you are over the age of 18. The Company does not permit those under 18 to use the Service.

Your access to and use of the Service is also conditioned on Your acceptance of and compliance with the Privacy Policy of the Company. Our Privacy Policy describes Our policies and procedures on the collection, use and disclosure of Your personal information when You use the Application or the Website and tells You about Your privacy rights and how the law protects You. Please read Our Privacy Policy carefully before using Our Service.

"},{"location":"legal/terms-of-service/#links-to-other-websites","title":"Links to Other Websites","text":"

Our Service may contain links to third-party websites or services that are not owned or controlled by the Company.

The Company has no control over, and assumes no responsibility for, the content, privacy policies, or practices of any third party websites or services. You further acknowledge and agree that the Company shall not be responsible or liable, directly or indirectly, for any damage or loss caused or alleged to be caused by or in connection with the use of or reliance on any such content, goods or services available on or through any such websites or services.

We strongly advise You to read the terms and conditions and privacy policies of any third-party websites or services that You visit.

"},{"location":"legal/terms-of-service/#termination","title":"Termination","text":"

We may terminate or suspend Your access immediately, without prior notice or liability, for any reason whatsoever, including without limitation if You breach these Terms and Conditions.

Upon termination, Your right to use the Service will cease immediately.

"},{"location":"legal/terms-of-service/#limitation-of-liability","title":"Limitation of Liability","text":"

Notwithstanding any damages that You might incur, the entire liability of the Company and any of its suppliers under any provision of these Terms and Your exclusive remedy for all the foregoing shall be limited to the amount actually paid by You through the Service or 100 USD if You haven't purchased anything through the Service.

To the maximum extent permitted by applicable law, in no event shall the Company or its suppliers be liable for any special, incidental, indirect, or consequential damages whatsoever (including, but not limited to, damages for loss of profits, loss of data or other information, for business interruption, for personal injury, loss of privacy arising out of or in any way related to the use of or inability to use the Service, third-party software and/or third-party hardware used with the Service, or otherwise in connection with any provision of these Terms), even if the Company or any supplier has been advised of the possibility of such damages and even if the remedy fails of its essential purpose.

Some states do not allow the exclusion of implied warranties or limitation of liability for incidental or consequential damages, which means that some of the above limitations may not apply. In these states, each party's liability will be limited to the greatest extent permitted by law.

"},{"location":"legal/terms-of-service/#as-is-and-as-available-disclaimer","title":"\"AS IS\" and \"AS AVAILABLE\" Disclaimer","text":"

The Service is provided to You \"AS IS\" and \"AS AVAILABLE\" and with all faults and defects without warranty of any kind. To the maximum extent permitted under applicable law, the Company, on its own behalf and on behalf of its Affiliates and its and their respective licensors and service providers, expressly disclaims all warranties, whether express, implied, statutory or otherwise, with respect to the Service, including all implied warranties of merchantability, fitness for a particular purpose, title and non-infringement, and warranties that may arise out of course of dealing, course of performance, usage or trade practice. Without limitation to the foregoing, the Company provides no warranty or undertaking, and makes no representation of any kind that the Service will meet Your requirements, achieve any intended results, be compatible or work with any other software, applications, systems or services, operate without interruption, meet any performance or reliability standards or be error free or that any errors or defects can or will be corrected.

Without limiting the foregoing, neither the Company nor any of the company's provider makes any representation or warranty of any kind, express or implied: (i) as to the operation or availability of the Service, or the information, content, and materials or products included thereon; (ii) that the Service will be uninterrupted or error-free; (iii) as to the accuracy, reliability, or currency of any information or content provided through the Service; or (iv) that the Service, its servers, the content, or e-mails sent from or on behalf of the Company are free of viruses, scripts, trojan horses, worms, malware, time-bombs or other harmful components.

Some jurisdictions do not allow the exclusion of certain types of warranties or limitations on applicable statutory rights of a consumer, so some or all of the above exclusions and limitations may not apply to You. But in such a case the exclusions and limitations set forth in this section shall be applied to the greatest extent enforceable under applicable law.

"},{"location":"legal/terms-of-service/#governing-law","title":"Governing Law","text":"

The laws of the Country, excluding its conflicts of law rules, shall govern this Terms and Your use of the Service. Your use of the Application may also be subject to other local, state, national, or international laws.

"},{"location":"legal/terms-of-service/#disputes-resolution","title":"Disputes Resolution","text":"

If You have any concern or dispute about the Service, You agree to first try to resolve the dispute informally by contacting the Company.

"},{"location":"legal/terms-of-service/#for-european-union-eu-users","title":"For European Union (EU) Users","text":"

If You are a European Union consumer, you will benefit from any mandatory provisions of the law of the country in which you are resident in.

"},{"location":"legal/terms-of-service/#united-states-legal-compliance","title":"United States Legal Compliance","text":"

You represent and warrant that (i) You are not located in a country that is subject to the United States government embargo, or that has been designated by the United States government as a \"terrorist supporting\" country, and (ii) You are not listed on any United States government list of prohibited or restricted parties.

"},{"location":"legal/terms-of-service/#severability-and-waiver","title":"Severability and Waiver","text":""},{"location":"legal/terms-of-service/#severability","title":"Severability","text":"

If any provision of these Terms is held to be unenforceable or invalid, such provision will be changed and interpreted to accomplish the objectives of such provision to the greatest extent possible under applicable law and the remaining provisions will continue in full force and effect.

"},{"location":"legal/terms-of-service/#waiver","title":"Waiver","text":"

Except as provided herein, the failure to exercise a right or to require performance of an obligation under these Terms shall not affect a party's ability to exercise such right or require such performance at any time thereafter nor shall the waiver of a breach constitute a waiver of any subsequent breach.

"},{"location":"legal/terms-of-service/#translation-interpretation","title":"Translation Interpretation","text":"

These Terms and Conditions may have been translated if We have made them available to You on our Service. You agree that the original English text shall prevail in the case of a dispute.

"},{"location":"legal/terms-of-service/#changes-to-these-terms-and-conditions","title":"Changes to These Terms and Conditions","text":"

We reserve the right, at Our sole discretion, to modify or replace these Terms at any time. If a revision is material We will make reasonable efforts to provide at least 30 days' notice prior to any new terms taking effect. What constitutes a material change will be determined at Our sole discretion.

By continuing to access or use Our Service after those revisions become effective, You agree to be bound by the revised terms. If You do not agree to the new terms, in whole or in part, please stop using the website and the Service.

"},{"location":"legal/terms-of-service/#contact-us","title":"Contact Us","text":"

If you have any questions about these Terms and Conditions, You can contact us:

  • By email: peter.flook@data.catering
"},{"location":"setup/","title":"Setup","text":"

All the configurations and customisation related to Data Caterer can be found under here.

"},{"location":"setup/#guide","title":"Guide","text":"

If you want a guided tour of using the Java or Scala API, you can follow one of the guides found here.

"},{"location":"setup/#specific-configuration","title":"Specific Configuration","text":"
  • Configurations - Configurations relating to feature flags, folder pathways, metadata analysis
  • Connections - Explore the data source connections available
  • Generators - Choose and configure the type of generator you want used for fields
  • Validations - How to validate data to ensure your system is performing as expected
  • Foreign Keys - Define links between data elements across data sources
  • Deployment - Deploy Data Caterer as a job to your chosen environment
  • Advanced - Advanced usage of Data Caterer
"},{"location":"setup/#high-level-run-configurations","title":"High Level Run Configurations","text":""},{"location":"setup/configuration/","title":"Configuration","text":"

A number of configurations can be made and customised within Data Caterer to help control what gets run and/or where any metadata gets saved.

These configurations are defined from within your Java or Scala class via configuration or for YAML file setup, application.conf file as seen here.

"},{"location":"setup/configuration/#flags","title":"Flags","text":"

Flags are used to control which processes are executed when you run Data Caterer.

Config Default Paid Description enableGenerateData true N Enable/disable data generation enableCount true N Count the number of records generated. Can be disabled to improve performance enableFailOnError true N Whilst saving generated data, if there is an error, it will stop any further data from being generated enableSaveReports true N Enable/disable HTML reports summarising data generated, metadata of data generated (if enableSinkMetadata is enabled) and validation results (if enableValidation is enabled). Sample here enableSinkMetadata true N Run data profiling for the generated data. Shown in HTML reports if enableSaveSinkMetadata is enabled enableValidation false N Run validations as described in plan. Results can be viewed from logs or from HTML report if enableSaveSinkMetadata is enabled. Sample here enableGeneratePlanAndTasks false Y Enable/disable plan and task auto generation based off data source connections enableRecordTracking false Y Enable/disable which data records have been generated for any data source enableDeleteGeneratedRecords false Y Delete all generated records based off record tracking (if enableRecordTracking has been set to true) enableGenerateValidations false Y If enabled, it will generate validations based on the data sources defined. JavaScalaapplication.conf 
configuration()\n  .enableGenerateData(true)\n  .enableCount(true)\n  .enableFailOnError(true)\n  .enableSaveReports(true)\n  .enableSinkMetadata(true)\n  .enableValidation(false)\n  .enableGeneratePlanAndTasks(false)\n  .enableRecordTracking(false)\n  .enableDeleteGeneratedRecords(false)\n  .enableGenerateValidations(false);\n
configuration\n  .enableGenerateData(true)\n  .enableCount(true)\n  .enableFailOnError(true)\n  .enableSaveReports(true)\n  .enableSinkMetadata(true)\n  .enableValidation(false)\n  .enableGeneratePlanAndTasks(false)\n  .enableRecordTracking(false)\n  .enableDeleteGeneratedRecords(false)\n  .enableGenerateValidations(false)\n
flags {\n  enableCount = false\n  enableCount = ${?ENABLE_COUNT}\n  enableGenerateData = true\n  enableGenerateData = ${?ENABLE_GENERATE_DATA}\n  enableFailOnError = true\n  enableFailOnError = ${?ENABLE_FAIL_ON_ERROR}\n  enableGeneratePlanAndTasks = false\n  enableGeneratePlanAndTasks = ${?ENABLE_GENERATE_PLAN_AND_TASKS}\n  enableRecordTracking = false\n  enableRecordTracking = ${?ENABLE_RECORD_TRACKING}\n  enableDeleteGeneratedRecords = false\n  enableDeleteGeneratedRecords = ${?ENABLE_DELETE_GENERATED_RECORDS}\n  enableGenerateValidations = false\n  enableGenerateValidations = ${?ENABLE_GENERATE_VALIDATIONS}\n}\n
"},{"location":"setup/configuration/#folders","title":"Folders","text":"

Depending on which flags are enabled, there are folders that get used to save metadata, store HTML reports or track the records generated.

These folder pathways can be defined as a cloud storage pathway (i.e. s3a://my-bucket/task).

Config Default Paid Description planFilePath /opt/app/plan/customer-create-plan.yaml N Plan file path to use when generating and/or validating data taskFolderPath /opt/app/task N Task folder path that contains all the task files (can have nested directories) validationFolderPath /opt/app/validation N Validation folder path that contains all the validation files (can have nested directories) generatedReportsFolderPath /opt/app/report N Where HTML reports get generated that contain information about data generated along with any validations performed generatedPlanAndTaskFolderPath /tmp Y Folder path where generated plan and task files will be saved recordTrackingFolderPath /opt/app/record-tracking Y Where record tracking parquet files get saved JavaScalaapplication.conf 
configuration()\n  .planFilePath(\"/opt/app/custom/plan/postgres-plan.yaml\")\n  .taskFolderPath(\"/opt/app/custom/task\")\n  .validationFolderPath(\"/opt/app/custom/validation\")\n  .generatedReportsFolderPath(\"/opt/app/custom/report\")\n  .generatedPlanAndTaskFolderPath(\"/opt/app/custom/generated\")\n  .recordTrackingFolderPath(\"/opt/app/custom/record-tracking\");\n
configuration\n  .planFilePath(\"/opt/app/custom/plan/postgres-plan.yaml\")\n  .taskFolderPath(\"/opt/app/custom/task\")\n  .validationFolderPath(\"/opt/app/custom/validation\")\n  .generatedReportsFolderPath(\"/opt/app/custom/report\")\n  .generatedPlanAndTaskFolderPath(\"/opt/app/custom/generated\")\n  .recordTrackingFolderPath(\"/opt/app/custom/record-tracking\")\n
folders {\n  planFilePath = \"/opt/app/custom/plan/postgres-plan.yaml\"\n  planFilePath = ${?PLAN_FILE_PATH}\n  taskFolderPath = \"/opt/app/custom/task\"\n  taskFolderPath = ${?TASK_FOLDER_PATH}\n  validationFolderPath = \"/opt/app/custom/validation\"\n  validationFolderPath = ${?VALIDATION_FOLDER_PATH}\n  generatedReportsFolderPath = \"/opt/app/custom/report\"\n  generatedReportsFolderPath = ${?GENERATED_REPORTS_FOLDER_PATH}\n  generatedPlanAndTaskFolderPath = \"/opt/app/custom/generated\"\n  generatedPlanAndTaskFolderPath = ${?GENERATED_PLAN_AND_TASK_FOLDER_PATH}\n  recordTrackingFolderPath = \"/opt/app/custom/record-tracking\"\n  recordTrackingFolderPath = ${?RECORD_TRACKING_FOLDER_PATH}\n}\n
"},{"location":"setup/configuration/#metadata","title":"Metadata","text":"

When metadata gets generated, there are some configurations that can be altered to help with performance or accuracy related issues. Metadata gets generated from two processes: 1) if enableGeneratePlanAndTasks or 2) if enableSinkMetadata are enabled.

During the generation of plan and tasks, data profiling is used to create the metadata for each of the fields defined in the data source. You may face issues if the number of records in the data source is large as data profiling is an expensive task. Similarly, it can be expensive when analysing the generated data if the number of records generated is large.

Config Default Paid Description numRecordsFromDataSource 10000 Y Number of records read in from the data source that could be used for data profiling numRecordsForAnalysis 10000 Y Number of records used for data profiling from the records gathered in numRecordsFromDataSource oneOfMinCount 1000 Y Minimum number of records required before considering if a field can be of type oneOf oneOfDistinctCountVsCountThreshold 0.2 Y Threshold ratio to determine if a field is of type oneOf (i.e. a field called status that only contains open or closed. Distinct count = 2, total count = 10, ratio = 2 / 10 = 0.2 therefore marked as oneOf) numGeneratedSamples 10 N Number of sample records from generated data to take. Shown in HTML report JavaScalaapplication.conf 
configuration()\n  .numRecordsFromDataSourceForDataProfiling(10000)\n  .numRecordsForAnalysisForDataProfiling(10000)\n  .oneOfMinCount(1000)\n  .oneOfDistinctCountVsCountThreshold(1000)\n  .numGeneratedSamples(10);\n
configuration\n  .numRecordsFromDataSourceForDataProfiling(10000)\n  .numRecordsForAnalysisForDataProfiling(10000)\n  .oneOfMinCount(1000)\n  .oneOfDistinctCountVsCountThreshold(1000)\n  .numGeneratedSamples(10)\n
metadata {\n  numRecordsFromDataSource = 10000\n  numRecordsForAnalysis = 10000\n  oneOfMinCount = 1000\n  oneOfDistinctCountVsCountThreshold = 0.2\n  numGeneratedSamples = 10\n}\n
"},{"location":"setup/configuration/#generation","title":"Generation","text":"

When generating data, you may have some limitations such as limited CPU or memory, large number of data sources, or data sources prone to failure under load. To help alleviate these issues or speed up performance, you can control the number of records that get generated in each batch.

Config Default Paid Description numRecordsPerBatch 100000 N Number of records across all data sources to generate per batch numRecordsPerStep N Overrides the count defined in each step with this value if defined (i.e. if set to 1000, for each step, 1000 records will be generated) ScalaScalaapplication.conf 
configuration()\n  .numRecordsPerBatch(100000)\n  .numRecordsPerStep(1000);\n
configuration\n  .numRecordsPerBatch(100000)\n  .numRecordsPerStep(1000)\n
generation {\n  numRecordsPerBatch = 100000\n  numRecordsPerStep = 1000\n}\n
"},{"location":"setup/configuration/#runtime","title":"Runtime","text":"

Given Data Caterer uses Spark as the base framework for data processing, you can configure the job as to your specifications via configuration as seen here.

JavaScalaapplication.conf 
configuration()\n  .master(\"local[*]\")\n  .runtimeConfig(Map.of(\"spark.driver.cores\", \"5\"))\n  .addRuntimeConfig(\"spark.driver.memory\", \"10g\");\n
configuration\n  .master(\"local[*]\")\n  .runtimeConfig(Map(\"spark.driver.cores\" -> \"5\"))\n  .addRuntimeConfig(\"spark.driver.memory\" -> \"10g\")\n
runtime {\n  master = \"local[*]\"\n  master = ${?DATA_CATERER_MASTER}\n  config {\n    \"spark.driver.cores\" = \"5\"\n    \"spark.driver.memory\" = \"10g\"\n  }\n}\n
"},{"location":"setup/advanced/advanced/","title":"Advanced use cases","text":""},{"location":"setup/advanced/advanced/#special-data-formats","title":"Special data formats","text":"

There are many options available for you to use when you have a scenario when data has to be a certain format.

  1. Create expression datafaker
    1. Can be used to create names, addresses, or anything that can be found under here
  2. Create regex
"},{"location":"setup/advanced/advanced/#foreign-keys-across-data-sets","title":"Foreign keys across data sets","text":"

Details for how you can configure foreign keys can be found here.

"},{"location":"setup/advanced/advanced/#edge-cases","title":"Edge cases","text":"

For each given data type, there are edge cases which can cause issues when your application processes the data. This can be controlled at a column level by including the following flag in the generator options:

JavaScalaYAML 
field()\n  .name(\"amount\")\n  .type(DoubleType.instance())\n  .enableEdgeCases(true)\n  .edgeCaseProbability(0.1)\n
field\n  .name(\"amount\")\n  .`type`(DoubleType)\n  .enableEdgeCases(true)\n  .edgeCaseProbability(0.1)\n
fields:\n  - name: \"amount\"\n    type: \"double\"\n    generator:\n      type: \"random\"\n      options:\n        enableEdgeCases: \"true\"\n        edgeCaseProb: 0.1\n

If you want to know all the possible edge cases for each data type, can check the documentation here.

"},{"location":"setup/advanced/advanced/#scenario-testing","title":"Scenario testing","text":"

You can create specific scenarios by adjusting the metadata found in the plan and tasks to your liking. For example, if you had two data sources, a Postgres database and a parquet file, and you wanted to save account data into Postgres and transactions related to those accounts into a parquet file. You can alter the status column in the account data to only generate open accounts and define a foreign key between Postgres and parquet to ensure the same account_id is being used. Then in the parquet task, define 1 to 10 transactions per account_id to be generated.

Postgres account generation example task Parquet transaction generation example task Plan

"},{"location":"setup/advanced/advanced/#cloud-storage","title":"Cloud storage","text":""},{"location":"setup/advanced/advanced/#data-source","title":"Data source","text":"

If you want to save the file types CSV, JSON, Parquet or ORC into cloud storage, you can do so via adding extra configurations. Below is an example for S3.

JavaScalaYAML 
var csvTask = csv(\"my_csv\", \"s3a://my-bucket/csv/accounts\")\n  .schema(\n    field().name(\"account_id\"),\n    ...\n  );\n\nvar s3Configuration = configuration()\n  .runtimeConfig(Map.of(\n    \"spark.hadoop.fs.s3a.directory.marker.retention\", \"keep\",\n    \"spark.hadoop.fs.s3a.bucket.all.committer.magic.enabled\", \"true\",\n    \"spark.hadoop.fs.defaultFS\", \"s3a://my-bucket\",\n    //can change to other credential providers as shown here\n    //https://hadoop.apache.org/docs/stable/hadoop-aws/tools/hadoop-aws/index.html#Changing_Authentication_Providers\n    \"spark.hadoop.fs.s3a.aws.credentials.provider\", \"org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider\",\n    \"spark.hadoop.fs.s3a.access.key\", \"access_key\",\n    \"spark.hadoop.fs.s3a.secret.key\", \"secret_key\"\n  ));\n\nexecute(s3Configuration, csvTask);\n
val csvTask = csv(\"my_csv\", \"s3a://my-bucket/csv/accounts\")\n  .schema(\n    field.name(\"account_id\"),\n    ...\n  )\n\nval s3Configuration = configuration\n  .runtimeConfig(Map(\n    \"spark.hadoop.fs.s3a.directory.marker.retention\" -> \"keep\",\n    \"spark.hadoop.fs.s3a.bucket.all.committer.magic.enabled\" -> \"true\",\n    \"spark.hadoop.fs.defaultFS\" -> \"s3a://my-bucket\",\n    //can change to other credential providers as shown here\n    //https://hadoop.apache.org/docs/stable/hadoop-aws/tools/hadoop-aws/index.html#Changing_Authentication_Providers\n    \"spark.hadoop.fs.s3a.aws.credentials.provider\" -> \"org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider\",\n    \"spark.hadoop.fs.s3a.access.key\" -> \"access_key\",\n    \"spark.hadoop.fs.s3a.secret.key\" -> \"secret_key\"\n  ))\n\nexecute(s3Configuration, csvTask)\n
folders {\n   generatedPlanAndTaskFolderPath = \"s3a://my-bucket/data-caterer/generated\"\n   planFilePath = \"s3a://my-bucket/data-caterer/generated/plan/customer-create-plan.yaml\"\n   taskFolderPath = \"s3a://my-bucket/data-caterer/generated/task\"\n}\n\nruntime {\n    config {\n        ...\n        #S3\n        \"spark.hadoop.fs.s3a.directory.marker.retention\" = \"keep\"\n        \"spark.hadoop.fs.s3a.bucket.all.committer.magic.enabled\" = \"true\"\n        \"spark.hadoop.fs.defaultFS\" = \"s3a://my-bucket\"\n        #can change to other credential providers as shown here\n        #https://hadoop.apache.org/docs/stable/hadoop-aws/tools/hadoop-aws/index.html#Changing_Authentication_Providers\n        \"spark.hadoop.fs.s3a.aws.credentials.provider\" = \"org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider\"\n        \"spark.hadoop.fs.s3a.access.key\" = \"access_key\"\n        \"spark.hadoop.fs.s3a.secret.key\" = \"secret_key\"\n   }\n}\n
"},{"location":"setup/advanced/advanced/#storing-plantasks","title":"Storing plan/task(s)","text":"

You can generate and store the plan/task files inside either AWS S3, Azure Blob Storage or Google GCS. This can be controlled via configuration set in the application.conf file where you can set something like the below:

JavaScalaYAML 
configuration()\n  .generatedReportsFolderPath(\"s3a://my-bucket/data-caterer/generated\")\n  .planFilePath(\"s3a://my-bucket/data-caterer/generated/plan/customer-create-plan.yaml\")\n  .taskFolderPath(\"s3a://my-bucket/data-caterer/generated/task\")\n  .runtimeConfig(Map.of(\n    \"spark.hadoop.fs.s3a.directory.marker.retention\", \"keep\",\n    \"spark.hadoop.fs.s3a.bucket.all.committer.magic.enabled\", \"true\",\n    \"spark.hadoop.fs.defaultFS\", \"s3a://my-bucket\",\n    //can change to other credential providers as shown here\n    //https://hadoop.apache.org/docs/stable/hadoop-aws/tools/hadoop-aws/index.html#Changing_Authentication_Providers\n    \"spark.hadoop.fs.s3a.aws.credentials.provider\", \"org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider\",\n    \"spark.hadoop.fs.s3a.access.key\", \"access_key\",\n    \"spark.hadoop.fs.s3a.secret.key\", \"secret_key\"\n  ));\n
configuration\n  .generatedReportsFolderPath(\"s3a://my-bucket/data-caterer/generated\")\n  .planFilePath(\"s3a://my-bucket/data-caterer/generated/plan/customer-create-plan.yaml\")\n  .taskFolderPath(\"s3a://my-bucket/data-caterer/generated/task\")\n  .runtimeConfig(Map(\n    \"spark.hadoop.fs.s3a.directory.marker.retention\" -> \"keep\",\n    \"spark.hadoop.fs.s3a.bucket.all.committer.magic.enabled\" -> \"true\",\n    \"spark.hadoop.fs.defaultFS\" -> \"s3a://my-bucket\",\n    //can change to other credential providers as shown here\n    //https://hadoop.apache.org/docs/stable/hadoop-aws/tools/hadoop-aws/index.html#Changing_Authentication_Providers\n    \"spark.hadoop.fs.s3a.aws.credentials.provider\" -> \"org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider\",\n    \"spark.hadoop.fs.s3a.access.key\" -> \"access_key\",\n    \"spark.hadoop.fs.s3a.secret.key\" -> \"secret_key\"\n  ))\n
folders {\n   generatedPlanAndTaskFolderPath = \"s3a://my-bucket/data-caterer/generated\"\n   planFilePath = \"s3a://my-bucket/data-caterer/generated/plan/customer-create-plan.yaml\"\n   taskFolderPath = \"s3a://my-bucket/data-caterer/generated/task\"\n}\n\nruntime {\n    config {\n        ...\n        #S3\n        \"spark.hadoop.fs.s3a.directory.marker.retention\" = \"keep\"\n        \"spark.hadoop.fs.s3a.bucket.all.committer.magic.enabled\" = \"true\"\n        \"spark.hadoop.fs.defaultFS\" = \"s3a://my-bucket\"\n        #can change to other credential providers as shown here\n        #https://hadoop.apache.org/docs/stable/hadoop-aws/tools/hadoop-aws/index.html#Changing_Authentication_Providers\n        \"spark.hadoop.fs.s3a.aws.credentials.provider\" = \"org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider\"\n        \"spark.hadoop.fs.s3a.access.key\" = \"access_key\"\n        \"spark.hadoop.fs.s3a.secret.key\" = \"secret_key\"\n   }\n}\n
"},{"location":"setup/connection/connection/","title":"Data Source Connections","text":"

Details of all the connection configuration supported can be found in the below subsections for each type of connection.

These configurations can be done via API or from configuration. Examples of both are shown for each data source below.

"},{"location":"setup/connection/connection/#supported-data-connections","title":"Supported Data Connections","text":"Data Source Type Data Source Paid Database Postgres, MySQL, Cassandra N (Postgres), Y (rest) File CSV, JSON, ORC, Parquet N Messaging Kafka, Solace Y HTTP REST API Y Metadata Marquez, OpenMetadata, OpenAPI/Swagger Y"},{"location":"setup/connection/connection/#api","title":"API","text":"

All connection details require a name. Depending on the data source, you can define additional options which may be used by the driver or connector for connecting to the data source.

"},{"location":"setup/connection/connection/#configuration-file","title":"Configuration file","text":"

All connection details follow the same pattern.

<connection format> {\n    <connection name> {\n        <key> = <value>\n    }\n}\n

Overriding configuration

When defining a configuration value that can be defined by a system property or environment variable at runtime, you can define that via the following:

url = \"localhost\"\nurl = ${?POSTGRES_URL}\n

The above defines that if there is a system property or environment variable named POSTGRES_URL, then that value will be used for the url, otherwise, it will default to localhost.

"},{"location":"setup/connection/connection/#data-sources","title":"Data sources","text":"

To find examples of a task for each type of data source, please check out this page.

"},{"location":"setup/connection/connection/#file","title":"File","text":"

Linked here is a list of generic options that can be included as part of your file data source configuration if required. Links to specific file type configurations can be found below.

"},{"location":"setup/connection/connection/#csv","title":"CSV","text":"JavaScalaapplication.conf 
csv(\"customer_transactions\", \"/data/customer/transaction\")\n
csv(\"customer_transactions\", \"/data/customer/transaction\")\n
csv {\n  customer_transactions {\n    path = \"/data/customer/transaction\"\n    path = ${?CSV_PATH}\n  }\n}\n

Other available configuration for CSV can be found here

"},{"location":"setup/connection/connection/#json","title":"JSON","text":"JavaScalaapplication.conf 
json(\"customer_transactions\", \"/data/customer/transaction\")\n
json(\"customer_transactions\", \"/data/customer/transaction\")\n
json {\n  customer_transactions {\n    path = \"/data/customer/transaction\"\n    path = ${?JSON_PATH}\n  }\n}\n

Other available configuration for JSON can be found here

"},{"location":"setup/connection/connection/#orc","title":"ORC","text":"JavaScalaapplication.conf 
orc(\"customer_transactions\", \"/data/customer/transaction\")\n
orc(\"customer_transactions\", \"/data/customer/transaction\")\n
orc {\n  customer_transactions {\n    path = \"/data/customer/transaction\"\n    path = ${?ORC_PATH}\n  }\n}\n

Other available configuration for ORC can be found here

"},{"location":"setup/connection/connection/#parquet","title":"Parquet","text":"JavaScalaapplication.conf 
parquet(\"customer_transactions\", \"/data/customer/transaction\")\n
parquet(\"customer_transactions\", \"/data/customer/transaction\")\n
parquet {\n  customer_transactions {\n    path = \"/data/customer/transaction\"\n    path = ${?PARQUET_PATH}\n  }\n}\n

Other available configuration for Parquet can be found here

"},{"location":"setup/connection/connection/#delta-not-supported-yet","title":"Delta (not supported yet)","text":"JavaScalaapplication.conf 
delta(\"customer_transactions\", \"/data/customer/transaction\")\n
delta(\"customer_transactions\", \"/data/customer/transaction\")\n
delta {\n  customer_transactions {\n    path = \"/data/customer/transaction\"\n    path = ${?DELTA_PATH}\n  }\n}\n
"},{"location":"setup/connection/connection/#rmdbs","title":"RMDBS","text":"

Follows the same configuration used by Spark as found here. Sample can be found below

JavaScalaapplication.conf 
postgres(\n    \"customer_postgres\",                            #name\n    \"jdbc:postgresql://localhost:5432/customer\",    #url\n    \"postgres\",                                     #username\n    \"postgres\"                                      #password\n)\n
postgres(\n    \"customer_postgres\",                            #name\n    \"jdbc:postgresql://localhost:5432/customer\",    #url\n    \"postgres\",                                     #username\n    \"postgres\"                                      #password\n)\n
jdbc {\n    customer_postgres {\n        url = \"jdbc:postgresql://localhost:5432/customer\"\n        url = ${?POSTGRES_URL}\n        user = \"postgres\"\n        user = ${?POSTGRES_USERNAME}\n        password = \"postgres\"\n        password = ${?POSTGRES_PASSWORD}\n        driver = \"org.postgresql.Driver\"\n    }\n}\n

Ensure that the user has write permission, so it is able to save the table to the target tables.

SQL Permission Statements 
GRANT INSERT ON <schema>.<table> TO <user>;\n
"},{"location":"setup/connection/connection/#postgres","title":"Postgres","text":"

Can see example API or Config definition for Postgres connection above.

"},{"location":"setup/connection/connection/#permissions","title":"Permissions","text":"

Following permissions are required when generating plan and tasks:

SQL Permission Statements 
GRANT SELECT ON information_schema.tables TO < user >;\nGRANT SELECT ON information_schema.columns TO < user >;\nGRANT SELECT ON information_schema.key_column_usage TO < user >;\nGRANT SELECT ON information_schema.table_constraints TO < user >;\nGRANT SELECT ON information_schema.constraint_column_usage TO < user >;\n
"},{"location":"setup/connection/connection/#mysql","title":"MySQL","text":"JavaScalaapplication.conf 
mysql(\n    \"customer_mysql\",                       #name\n    \"jdbc:mysql://localhost:3306/customer\", #url\n    \"root\",                                 #username\n    \"root\"                                  #password\n)\n
mysql(\n    \"customer_mysql\",                       #name\n    \"jdbc:mysql://localhost:3306/customer\", #url\n    \"root\",                                 #username\n    \"root\"                                  #password\n)\n
jdbc {\n    customer_mysql {\n        url = \"jdbc:mysql://localhost:3306/customer\"\n        user = \"root\"\n        password = \"root\"\n        driver = \"com.mysql.cj.jdbc.Driver\"\n    }\n}\n
"},{"location":"setup/connection/connection/#permissions_1","title":"Permissions","text":"

Following permissions are required when generating plan and tasks:

SQL Permission Statements 
GRANT SELECT ON information_schema.columns TO < user >;\nGRANT SELECT ON information_schema.statistics TO < user >;\nGRANT SELECT ON information_schema.key_column_usage TO < user >;\n
"},{"location":"setup/connection/connection/#cassandra","title":"Cassandra","text":"

Follows same configuration as defined by the Spark Cassandra Connector as found here

JavaScalaapplication.conf 
cassandra(\n    \"customer_cassandra\",   #name\n    \"localhost:9042\",       #url\n    \"cassandra\",            #username\n    \"cassandra\",            #password\n    Map.of()                #optional additional connection options\n)\n
cassandra(\n    \"customer_cassandra\",   #name\n    \"localhost:9042\",       #url\n    \"cassandra\",            #username\n    \"cassandra\",            #password\n    Map()                #optional additional connection options\n)\n
org.apache.spark.sql.cassandra {\n    customer_cassandra {\n        spark.cassandra.connection.host = \"localhost\"\n        spark.cassandra.connection.host = ${?CASSANDRA_HOST}\n        spark.cassandra.connection.port = \"9042\"\n        spark.cassandra.connection.port = ${?CASSANDRA_PORT}\n        spark.cassandra.auth.username = \"cassandra\"\n        spark.cassandra.auth.username = ${?CASSANDRA_USERNAME}\n        spark.cassandra.auth.password = \"cassandra\"\n        spark.cassandra.auth.password = ${?CASSANDRA_PASSWORD}\n    }\n}\n
"},{"location":"setup/connection/connection/#permissions_2","title":"Permissions","text":"

Ensure that the user has write permission, so it is able to save the table to the target tables.

CQL Permission Statements 
GRANT INSERT ON <schema>.<table> TO <user>;\n

Following permissions are required when enabling configuration.enableGeneratePlanAndTasks(true) as it will gather metadata information about tables and columns from the below tables.

CQL Permission Statements 
GRANT SELECT ON system_schema.tables TO <user>;\nGRANT SELECT ON system_schema.columns TO <user>;\n
"},{"location":"setup/connection/connection/#kafka","title":"Kafka","text":"

Define your Kafka bootstrap server to connect and send generated data to corresponding topics. Topic gets set at a step level. Further details can be found here

JavaScalaapplication.conf 
kafka(\n    \"customer_kafka\",   #name\n    \"localhost:9092\"    #url\n)\n
kafka(\n    \"customer_kafka\",   #name\n    \"localhost:9092\"    #url\n)\n
kafka {\n    customer_kafka {\n        kafka.bootstrap.servers = \"localhost:9092\"\n        kafka.bootstrap.servers = ${?KAFKA_BOOTSTRAP_SERVERS}\n    }\n}\n

When defining your schema for pushing data to Kafka, it follows a specific top level schema. An example can be found here . You can define the key, value, headers, partition or topic by following the linked schema.

"},{"location":"setup/connection/connection/#jms","title":"JMS","text":"

Uses JNDI lookup to send messages to JMS queue. Ensure that the messaging system you are using has your queue/topic registered via JNDI otherwise a connection cannot be created.

JavaScalaapplication.conf 
solace(\n    \"customer_solace\",                                      #name\n    \"smf://localhost:55554\",                                #url\n    \"admin\",                                                #username\n    \"admin\",                                                #password\n    \"default\",                                              #vpn name\n    \"/jms/cf/default\",                                      #connection factory\n    \"com.solacesystems.jndi.SolJNDIInitialContextFactory\"   #initial context factory\n)\n
solace(\n    \"customer_solace\",                                      #name\n    \"smf://localhost:55554\",                                #url\n    \"admin\",                                                #username\n    \"admin\",                                                #password\n    \"default\",                                              #vpn name\n    \"/jms/cf/default\",                                      #connection factory\n    \"com.solacesystems.jndi.SolJNDIInitialContextFactory\"   #initial context factory\n)\n
jms {\n    customer_solace {\n        initialContextFactory = \"com.solacesystems.jndi.SolJNDIInitialContextFactory\"\n        connectionFactory = \"/jms/cf/default\"\n        url = \"smf://localhost:55555\"\n        url = ${?SOLACE_URL}\n        user = \"admin\"\n        user = ${?SOLACE_USER}\n        password = \"admin\"\n        password = ${?SOLACE_PASSWORD}\n        vpnName = \"default\"\n        vpnName = ${?SOLACE_VPN}\n    }\n}\n
"},{"location":"setup/connection/connection/#http","title":"HTTP","text":"

Define any username and/or password needed for the HTTP requests. The url is defined in the tasks to allow for generated data to be populated in the url.

JavaScalaapplication.conf 
http(\n    \"customer_api\", #name\n    \"admin\",        #username\n    \"admin\"         #password\n)\n
http(\n    \"customer_api\", #name\n    \"admin\",        #username\n    \"admin\"         #password\n)\n
http {\n    customer_api {\n        user = \"admin\"\n        user = ${?HTTP_USER}\n        password = \"admin\"\n        password = ${?HTTP_PASSWORD}\n    }\n}\n
"},{"location":"setup/deployment/deployment/","title":"Deployment","text":"

Two main ways to deploy and run Data Caterer:

  • Docker
  • Helm
"},{"location":"setup/deployment/deployment/#docker","title":"Docker","text":"

To package up your class along with the Data Caterer base image, you can follow the Dockerfile that is created for you here.

Then you can run the following:

./gradlew clean build\ndocker build -t <my_image_name>:<my_image_tag> .\n
"},{"location":"setup/deployment/deployment/#helm","title":"Helm","text":"

Link to sample helm on GitHub here

Update the configuration to your own data connections and configuration or own image created from above.

git clone git@github.com:pflooky/data-caterer-example.git\nhelm install data-caterer ./data-caterer-example/helm/data-caterer\n
"},{"location":"setup/foreign-key/foreign-key/","title":"Foreign Keys","text":"

Foreign keys can be defined to represent the relationships between datasets where values are required to match for particular columns.

"},{"location":"setup/foreign-key/foreign-key/#single-column","title":"Single column","text":"

Define a column in one data source to match against another column. Below example shows a postgres data source with two tables, accounts and transactions that have a foreign key for account_id.

JavaScalaYAML 
var postgresAcc = postgres(\"my_postgres\", \"jdbc:...\")\n  .table(\"public.accounts\")\n  .schema(\n    field().name(\"account_id\"),\n    field().name(\"name\"),\n    ...\n  );\nvar postgresTxn = postgres(postgresAcc)\n  .table(\"public.transactions\")\n  .schema(\n    field().name(\"account_id\"),\n    field().name(\"full_name\"),\n    ...\n  );\n\nplan().addForeignKeyRelationship(\n  postgresAcc, \"account_id\",\n  List.of(Map.entry(postgresTxn, \"account_id\"))\n);\n
val postgresAcc = postgres(\"my_postgres\", \"jdbc:...\")\n  .table(\"public.accounts\")\n  .schema(\n    field.name(\"account_id\"),\n    field.name(\"name\"),\n    ...\n  )\nval postgresTxn = postgres(postgresAcc)\n  .table(\"public.transactions\")\n  .schema(\n    field.name(\"account_id\"),\n    field.name(\"full_name\"),\n    ...\n  )\n\nplan.addForeignKeyRelationship(\n  postgresAcc, \"account_id\",\n  List(postgresTxn -> \"account_id\")\n)\n
---\nname: \"postgres_data\"\nsteps:\n  - name: \"accounts\"\n    type: \"postgres\"\n    options:\n      dbtable: \"account.accounts\"\n    schema:\n      fields:\n        - name: \"account_id\"\n        - name: \"name\"\n  - name: \"transactions\"\n    type: \"postgres\"\n    options:\n      dbtable: \"account.transactions\"\n    schema:\n      fields:\n        - name: \"account_id\"\n        - name: \"full_name\"\n---\nname: \"customer_create_plan\"\ndescription: \"Create customers in JDBC\"\ntasks:\n  - name: \"postgres_data\"\n    dataSourceName: \"my_postgres\"\n\nsinkOptions:\n  foreignKeys:\n    \"postgres.accounts.account_id\":\n      - \"postgres.transactions.account_id\"\n
"},{"location":"setup/foreign-key/foreign-key/#multiple-columns","title":"Multiple columns","text":"

You may have a scenario where multiple columns need to be aligned. From the same example, we want account_id and name from accounts to match with account_id and full_name to match in transactions respectively.

JavaScalaYAML 
var postgresAcc = postgres(\"my_postgres\", \"jdbc:...\")\n  .table(\"public.accounts\")\n  .schema(\n    field().name(\"account_id\"),\n    field().name(\"name\"),\n    ...\n  );\nvar postgresTxn = postgres(postgresAcc)\n  .table(\"public.transactions\")\n  .schema(\n    field().name(\"account_id\"),\n    field().name(\"full_name\"),\n    ...\n  );\n\nplan().addForeignKeyRelationship(\n  postgresAcc, List.of(\"account_id\", \"name\"),\n  List.of(Map.entry(postgresTxn, List.of(\"account_id\", \"full_name\")))\n);\n
val postgresAcc = postgres(\"my_postgres\", \"jdbc:...\")\n  .table(\"public.accounts\")\n  .schema(\n    field.name(\"account_id\"),\n    field.name(\"name\"),\n    ...\n  )\nval postgresTxn = postgres(postgresAcc)\n  .table(\"public.transactions\")\n  .schema(\n    field.name(\"account_id\"),\n    field.name(\"full_name\"),\n    ...\n  )\n\nplan.addForeignKeyRelationship(\n  postgresAcc, List(\"account_id\", \"name\"),\n  List(postgresTxn -> List(\"account_id\", \"full_name\"))\n)\n
---\nname: \"postgres_data\"\nsteps:\n  - name: \"accounts\"\n    type: \"postgres\"\n    options:\n      dbtable: \"account.accounts\"\n    schema:\n      fields:\n        - name: \"account_id\"\n        - name: \"name\"\n  - name: \"transactions\"\n    type: \"postgres\"\n    options:\n      dbtable: \"account.transactions\"\n    schema:\n      fields:\n        - name: \"account_id\"\n        - name: \"full_name\"\n---\nname: \"customer_create_plan\"\ndescription: \"Create customers in JDBC\"\ntasks:\n  - name: \"postgres_data\"\n    dataSourceName: \"my_postgres\"\n\nsinkOptions:\n  foreignKeys:\n    \"my_postgres.accounts.account_id,name\":\n      - \"my_postgres.transactions.account_id,full_name\"\n
"},{"location":"setup/foreign-key/foreign-key/#nested-column","title":"Nested column","text":"

Your schema structure can have nested fields which can also be referenced as foreign keys. But to do so, you need to create a proxy field that gets omitted from the final saved data.

In the example below, the nested customer_details.name field inside the json task needs to match with name from postgres. A new field in the json called _txn_name is used as a temporary column to facilitate the foreign key definition.

JavaScalaYAML 
var postgresAcc = postgres(\"my_postgres\", \"jdbc:...\")\n  .table(\"public.accounts\")\n  .schema(\n    field().name(\"account_id\"),\n    field().name(\"name\"),\n    ...\n  );\nvar jsonTask = json(\"my_json\", \"/tmp/json\")\n  .schema(\n    field().name(\"account_id\"),\n    field().name(\"customer_details\")\n      .schema(\n        field().name(\"name\").sql(\"_txn_name\"), #nested field will get value from '_txn_name'\n        ...\n      ),\n    field().name(\"_txn_name\").omit(true)       #value will not be included in output\n  );\n\nplan().addForeignKeyRelationship(\n  postgresAcc, List.of(\"account_id\", \"name\"),\n  List.of(Map.entry(jsonTask, List.of(\"account_id\", \"_txn_name\")))\n);\n
val postgresAcc = postgres(\"my_postgres\", \"jdbc:...\")\n  .table(\"public.accounts\")\n  .schema(\n    field.name(\"account_id\"),\n    field.name(\"name\"),\n    ...\n  )\nvar jsonTask = json(\"my_json\", \"/tmp/json\")\n  .schema(\n    field.name(\"account_id\"),\n    field.name(\"customer_details\")\n      .schema(\n        field.name(\"name\").sql(\"_txn_name\"), #nested field will get value from '_txn_name'\n        ...\n      ), \n    field.name(\"_txn_name\").omit(true)       #value will not be included in output\n  )\n\nplan.addForeignKeyRelationship(\n  postgresAcc, List(\"account_id\", \"name\"),\n  List(jsonTask -> List(\"account_id\", \"_txn_name\"))\n)\n
---\n#postgres task yaml\nname: \"postgres_data\"\nsteps:\n  - name: \"accounts\"\n    type: \"postgres\"\n    options:\n      dbtable: \"account.accounts\"\n    schema:\n      fields:\n        - name: \"account_id\"\n        - name: \"name\"\n---\n#json task yaml\nname: \"json_data\"\nsteps:\n  - name: \"transactions\"\n    type: \"json\"\n    options:\n      dbtable: \"account.transactions\"\n    schema:\n      fields:\n        - name: \"account_id\"\n        - name: \"_txn_name\"\n          generator:\n            options:\n              omit: true\n        - name: \"cusotmer_details\"\n          schema:\n            fields:\n              name: \"name\"\n              generator:\n                type: \"sql\"\n                options:\n                  sql: \"_txn_name\"\n\n---\n#plan yaml\nname: \"customer_create_plan\"\ndescription: \"Create customers in JDBC\"\ntasks:\n  - name: \"postgres_data\"\n    dataSourceName: \"my_postgres\"\n  - name: \"json_data\"\n    dataSourceName: \"my_json\"\n\nsinkOptions:\n  foreignKeys:\n    \"my_postgres.accounts.account_id,name\":\n      - \"my_json.transactions.account_id,_txn_name\"\n
"},{"location":"setup/generator/count/","title":"Record Count","text":"

There are options related to controlling the number of records generated that can help in generating the scenarios or data required.

"},{"location":"setup/generator/count/#record-count_1","title":"Record Count","text":"

Record count is the simplest as you define the total number of records you require for that particular step. For example, in the below step, it will generate 1000 records for the CSV file

JavaScalaYAML 
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .count(1000);\n
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .count(1000)\n
name: \"csv_file\"\nsteps:\n  - name: \"transactions\"\n    type: \"csv\"\n    options:\n      path: \"app/src/test/resources/sample/csv/transactions\"\n    count:\n      records: 1000\n
"},{"location":"setup/generator/count/#generated-count","title":"Generated Count","text":"

As like most things in Data Caterer, the count can be generated based on some metadata. For example, if I wanted to generate between 1000 and 2000 records, I could define that by the below configuration:

JavaScalaYAML 
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .count(generator().min(1000).max(2000));\n
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .count(generator.min(1000).max(2000))\n
name: \"csv_file\"\nsteps:\n  - name: \"transactions\"\n    type: \"csv\"\n    options:\n      path: \"app/src/test/resources/sample/csv/transactions\"\n    count:\n      generator:\n        type: \"random\"\n        options:\n          min: 1000\n          max: 2000\n
"},{"location":"setup/generator/count/#per-column-count","title":"Per Column Count","text":"

When defining a per column count, this allows you to generate records \"per set of columns\". This means that for a given set of columns, it will generate a particular amount of records per combination of values for those columns.

One example of this would be when generating transactions relating to a customer, a customer may be defined by columns account_id, name. A number of transactions would be generated per account_id, name.

You can also use a combination of the above two methods to generate the number of records per column.

"},{"location":"setup/generator/count/#records","title":"Records","text":"

When defining a base number of records within the perColumn configuration, it translates to creating (count.records * count.recordsPerColumn) records. This is a fixed number of records that will be generated each time, with no variation between runs.

In the example below, we have count.records = 1000 and count.recordsPerColumn = 2. Which means that 1000 * 2 = 2000 records will be generated in total.

JavaScalaYAML 
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .count(\n    count()\n      .records(1000)\n      .recordsPerColumn(2, \"account_id\", \"name\")\n  );\n
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .count(\n    count\n      .records(1000)\n      .recordsPerColumn(2, \"account_id\", \"name\")\n  )\n
name: \"csv_file\"\nsteps:\n  - name: \"transactions\"\n    type: \"csv\"\n    options:\n      path: \"app/src/test/resources/sample/csv/transactions\"\n    count:\n      records: 1000\n      perColumn:\n        records: 2\n        columnNames:\n          - \"account_id\"\n          - \"name\"\n
"},{"location":"setup/generator/count/#generated","title":"Generated","text":"

You can also define a generator for the count per column. This can be used in scenarios where you want a variable number of records per set of columns.

In the example below, it will generate between (count.records * count.perColumnGenerator.generator.min) = (1000 * 1) = 1000 and (count.records * count.perColumnGenerator.generator.max) = (1000 * 2) = 2000 records.

JavaScalaYAML 
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .count(\n    count()\n      .records(1000)\n      .recordsPerColumnGenerator(generator().min(1).max(2), \"account_id\", \"name\")\n  );\n
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .count(\n    count\n      .records(1000)\n      .recordsPerColumnGenerator(generator.min(1).max(2), \"account_id\", \"name\")\n  )\n
name: \"csv_file\"\nsteps:\n  - name: \"transactions\"\n    type: \"csv\"\n    options:\n      path: \"app/src/test/resources/sample/csv/transactions\"\n    count:\n      records: 1000\n      perColumn:\n        columnNames:\n          - \"account_id\"\n          - \"name\"\n        generator:\n          type: \"random\"\n          options:\n            min: 1\n            max: 2\n
"},{"location":"setup/generator/generator/","title":"Data Generators","text":""},{"location":"setup/generator/generator/#data-types","title":"Data Types","text":"

Below is a list of all supported data types for generating data:

Data Type Spark Data Type Options Description string StringType minLen, maxLen, expression, enableNull integer IntegerType min, max, stddev, mean long LongType min, max, stddev, mean short ShortType min, max, stddev, mean decimal(precision, scale) DecimalType(precision, scale) min, max, stddev, mean double DoubleType min, max, stddev, mean float FloatType min, max, stddev, mean date DateType min, max, enableNull timestamp TimestampType min, max, enableNull boolean BooleanType binary BinaryType minLen, maxLen, enableNull byte ByteType array ArrayType arrayMinLen, arrayMaxLen, arrayType _ StructType Implicitly supported when a schema is defined for a field"},{"location":"setup/generator/generator/#options","title":"Options","text":""},{"location":"setup/generator/generator/#all-data-types","title":"All data types","text":"

Some options are available to use for all types of data generators. Below is the list along with example and descriptions:

Option Default Example Description enableEdgeCase false enableEdgeCase: \"true\" Enable/disable generated data to contain edge cases based on the data type. For example, integer data type has edge cases of (Int.MaxValue, Int.MinValue and 0) edgeCaseProbability 0.0 edgeCaseProb: \"0.1\" Probability of generating a random edge case value if enableEdgeCase is true isUnique false isUnique: \"true\" Enable/disable generated data to be unique for that column. Errors will be thrown when it is unable to generate unique data seed seed: \"1\" Defines the random seed for generating data for that particular column. It will override any seed defined at a global level sql sql: \"CASE WHEN amount < 10 THEN true ELSE false END\" Define any SQL statement for generating that columns value. Computation occurs after all non-SQL fields are generated. This means any columns used in the SQL cannot be based on other SQL generated columns. Data type of generated value from SQL needs to match data type defined for the field"},{"location":"setup/generator/generator/#string","title":"String","text":"Option Default Example Description minLen 1 minLen: \"2\" Ensures that all generated strings have at least length minLen maxLen 10 maxLen: \"15\" Ensures that all generated strings have at most length maxLen expression expression: \"#{Name.name}\"expression:\"#{Address.city}/#{Demographic.maritalStatus}\" Will generate a string based on the faker expression provided. All possible faker expressions can be found here Expression has to be in format #{<faker expression name>} enableNull false enableNull: \"true\" Enable/disable null values being generated nullProbability 0.0 nullProb: \"0.1\" Probability to generate null values if enableNull is true

Edge cases: (\"\", \"\\n\", \"\\r\", \"\\t\", \" \", \"\\u0000\", \"\\ufff\", \"\u0130yi g\u00fcnler\", \"\u0421\u043f\u0430\u0441\u0438\u0431\u043e\", \"\u039a\u03b1\u03bb\u03b7\u03bc\u03ad\u03c1\u03b1\", \"\u0635\u0628\u0627\u062d \u0627\u0644\u062e\u064a\u0631\", \" F\u00f6rl\u00e5t\", \"\u4f60\u597d\u5417\", \"Nh\u00e0 v\u1ec7 sinh \u1edf \u0111\u00e2u\", \"\u3053\u3093\u306b\u3061\u306f\", \"\u0928\u092e\u0938\u094d\u0924\u0947\", \"\u0532\u0561\u0580\u0565\u0582\", \"\u0417\u0434\u0440\u0430\u0432\u0435\u0439\u0442\u0435\")

"},{"location":"setup/generator/generator/#sample","title":"Sample","text":"JavaScalaYAML 
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field()\n      .name(\"name\")\n      .type(StringType.instance())\n      .expression(\"#{Name.name}\")\n      .enableNull(true)\n      .nullProbability(0.1)\n      .minLength(4)\n      .maxLength(20)\n  );\n
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field\n      .name(\"name\")\n      .`type`(StringType)\n      .expression(\"#{Name.name}\")\n      .enableNull(true)\n      .nullProbability(0.1)\n      .minLength(4)\n      .maxLength(20)\n  )\n
name: \"csv_file\"\nsteps:\n  - name: \"transactions\"\n    type: \"csv\"\n    options:\n      path: \"app/src/test/resources/sample/csv/transactions\"\n    schema:\n      fields:\n        - name: \"name\"\n          type: \"string\"\n          generator:\n            options:\n              expression: \"#{Name.name}\"\n              enableNull: true\n              nullProb: 0.1\n              minLength: 4\n              maxLength: 20\n
"},{"location":"setup/generator/generator/#numeric","title":"Numeric","text":"

For all the numeric data types, there are 4 options to choose from: min, max and maxValue. Generally speaking, you only need to define one of min or minValue, similarly with max or maxValue. The reason why there are 2 options for each is because of when metadata is automatically gathered, we gather the statistics of the observed min and max values. Also, it will attempt to gather any restriction on the min or max value as defined by the data source (i.e. max value as per database type).

"},{"location":"setup/generator/generator/#integerlongshort","title":"Integer/Long/Short","text":"Option Default Example Description min 0 min: \"2\" Ensures that all generated values are greater than or equal to min max 1000 max: \"25\" Ensures that all generated values are less than or equal to max stddev 1.0 stddev: \"2.0\" Standard deviation for normal distributed data mean max - min mean: \"5.0\" Mean for normal distributed data

Edge cases Integer: (2147483647, -2147483648, 0) Edge cases Long: (9223372036854775807, -9223372036854775808, 0) Edge cases Short: (32767, -32768, 0)

"},{"location":"setup/generator/generator/#sample_1","title":"Sample","text":"JavaScalaYAML 
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field().name(\"year\").type(IntegerType.instance()).min(2020).max(2023),\n    field().name(\"customer_id\").type(LongType.instance()),\n    field().name(\"customer_group\").type(ShortType.instance())\n  );\n
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field.name(\"year\").`type`(IntegerType).min(2020).max(2023),\n    field.name(\"customer_id\").`type`(LongType),\n    field.name(\"customer_group\").`type`(ShortType)\n  )\n
name: \"csv_file\"\nsteps:\n  - name: \"transactions\"\n    ...\n    schema:\n      fields:\n        - name: \"year\"\n          type: \"integer\"\n          generator:\n            options:\n              min: 2020\n              max: 2023\n        - name: \"customer_id\"\n          type: \"long\"\n        - name: \"customer_group\"\n          type: \"short\"\n
"},{"location":"setup/generator/generator/#decimal","title":"Decimal","text":"Option Default Example Description min 0 min: \"2\" Ensures that all generated values are greater than or equal to min max 1000 max: \"25\" Ensures that all generated values are less than or equal to max stddev 1.0 stddev: \"2.0\" Standard deviation for normal distributed data mean max - min mean: \"5.0\" Mean for normal distributed data numericPrecision 10 precision: \"25\" The maximum number of digits numericScale 0 scale: \"25\" The number of digits on the right side of the decimal point (has to be less than or equal to precision)

Edge cases Decimal: (9223372036854775807, -9223372036854775808, 0)

"},{"location":"setup/generator/generator/#sample_2","title":"Sample","text":"JavaScalaYAML 
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field().name(\"balance\").type(DecimalType.instance()).numericPrecision(10).numericScale(5)\n  );\n
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field.name(\"balance\").`type`(DecimalType).numericPrecision(10).numericScale(5)\n  )\n
name: \"csv_file\"\nsteps:\n  - name: \"transactions\"\n    ...\n    schema:\n      fields:\n        - name: \"balance\"\n          type: \"decimal\"\n            generator:\n              options:\n                precision: 10\n                scale: 5\n
"},{"location":"setup/generator/generator/#doublefloat","title":"Double/Float","text":"Option Default Example Description min 0.0 min: \"2.1\" Ensures that all generated values are greater than or equal to min max 1000.0 max: \"25.9\" Ensures that all generated values are less than or equal to max stddev 1.0 stddev: \"2.0\" Standard deviation for normal distributed data mean max - min mean: \"5.0\" Mean for normal distributed data

Edge cases Double: (+infinity, 1.7976931348623157e+308, 4.9e-324, 0.0, -0.0, -1.7976931348623157e+308, -infinity, NaN) Edge cases Float: (+infinity, 3.4028235e+38, 1.4e-45, 0.0, -0.0, -3.4028235e+38, -infinity, NaN)

"},{"location":"setup/generator/generator/#sample_3","title":"Sample","text":"JavaScalaYAML 
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field().name(\"amount\").type(DoubleType.instance())\n  );\n
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field.name(\"amount\").`type`(DoubleType)\n  )\n
name: \"csv_file\"\nsteps:\n  - name: \"transactions\"\n    ...\n    schema:\n      fields:\n        - name: \"amount\"\n          type: \"double\"\n
"},{"location":"setup/generator/generator/#date","title":"Date","text":"Option Default Example Description min now() - 365 days min: \"2023-01-31\" Ensures that all generated values are greater than or equal to min max now() max: \"2023-12-31\" Ensures that all generated values are less than or equal to max enableNull false enableNull: \"true\" Enable/disable null values being generated nullProbability 0.0 nullProb: \"0.1\" Probability to generate null values if enableNull is true

Edge cases: (0001-01-01, 1582-10-15, 1970-01-01, 9999-12-31) (reference)

"},{"location":"setup/generator/generator/#sample_4","title":"Sample","text":"JavaScalaYAML 
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field().name(\"created_date\").type(DateType.instance()).min(java.sql.Date.valueOf(\"2020-01-01\"))\n  );\n
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field.name(\"created_date\").`type`(DateType).min(java.sql.Date.valueOf(\"2020-01-01\"))\n  )\n
name: \"csv_file\"\nsteps:\n  - name: \"transactions\"\n    ...\n    schema:\n      fields:\n        - name: \"created_date\"\n          type: \"date\"\n            generator:\n              options:\n                min: \"2020-01-01\"\n
"},{"location":"setup/generator/generator/#timestamp","title":"Timestamp","text":"Option Default Example Description min now() - 365 days min: \"2023-01-31 23:10:10\" Ensures that all generated values are greater than or equal to min max now() max: \"2023-12-31 23:10:10\" Ensures that all generated values are less than or equal to max enableNull false enableNull: \"true\" Enable/disable null values being generated nullProbability 0.0 nullProb: \"0.1\" Probability to generate null values if enableNull is true

Edge cases: (0001-01-01 00:00:00, 1582-10-15 23:59:59, 1970-01-01 00:00:00, 9999-12-31 23:59:59)

"},{"location":"setup/generator/generator/#sample_5","title":"Sample","text":"JavaScalaYAML 
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field().name(\"created_time\").type(TimestampType.instance()).min(java.sql.Timestamp.valueOf(\"2020-01-01 00:00:00\"))\n  );\n
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field.name(\"created_time\").`type`(TimestampType).min(java.sql.Timestamp.valueOf(\"2020-01-01 00:00:00\"))\n  )\n
name: \"csv_file\"\nsteps:\n  - name: \"transactions\"\n    ...\n    schema:\n      fields:\n        - name: \"created_time\"\n          type: \"timestamp\"\n            generator:\n              options:\n                min: \"2020-01-01 00:00:00\"\n
"},{"location":"setup/generator/generator/#binary","title":"Binary","text":"Option Default Example Description minLen 1 minLen: \"2\" Ensures that all generated array of bytes have at least length minLen maxLen 20 maxLen: \"15\" Ensures that all generated array of bytes have at most length maxLen enableNull false enableNull: \"true\" Enable/disable null values being generated nullProbability 0.0 nullProb: \"0.1\" Probability to generate null values if enableNull is true

Edge cases: (\"\", \"\\n\", \"\\r\", \"\\t\", \" \", \"\\u0000\", \"\\ufff\", -128, 127)

"},{"location":"setup/generator/generator/#sample_6","title":"Sample","text":"JavaScalaYAML 
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field().name(\"payload\").type(BinaryType.instance())\n  );\n
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field.name(\"payload\").`type`(BinaryType)\n  )\n
name: \"csv_file\"\nsteps:\n  - name: \"transactions\"\n    ...\n    schema:\n      fields:\n        - name: \"payload\"\n          type: \"binary\"\n
"},{"location":"setup/generator/generator/#array","title":"Array","text":"Option Default Example Description arrayMinLen 0 arrayMinLen: \"2\" Ensures that all generated arrays have at least length arrayMinLen arrayMaxLen 5 arrayMaxLen: \"15\" Ensures that all generated arrays have at most length arrayMaxLen arrayType arrayType: \"double\" Inner data type of the array. Optional when using Java/Scala API. Allows for nested data types to be defined like struct enableNull false enableNull: \"true\" Enable/disable null values being generated nullProbability 0.0 nullProb: \"0.1\" Probability to generate null values if enableNull is true"},{"location":"setup/generator/generator/#sample_7","title":"Sample","text":"JavaScalaYAML 
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field().name(\"last_5_amounts\").type(ArrayType.instance()).arrayType(\"double\")\n  );\n
csv(\"transactions\", \"app/src/test/resources/sample/csv/transactions\")\n  .schema(\n    field.name(\"last_5_amounts\").`type`(ArrayType).arrayType(\"double\")\n  )\n
name: \"csv_file\"\nsteps:\n  - name: \"transactions\"\n    ...\n    schema:\n      fields:\n        - name: \"last_5_amounts\"\n          type: \"array<double>\"\n
"},{"location":"setup/generator/report/","title":"Report","text":"

Data Caterer can be configured to produce a report of the data generated to help users understand what was run, how much data was generated, where it was generated, validation results and any associated metadata.

"},{"location":"setup/generator/report/#sample","title":"Sample","text":"

Once run, it will produce a report like this.

"},{"location":"setup/guide/","title":"Guides","text":"

Below are a list of guides you can follow to create your data generation for your use case.

For any of the paid tier guides, you can use the trial version fo the app to try it out. Details on how to get the trial can be found here.

"},{"location":"setup/guide/#scenarios","title":"Scenarios","text":"

Free tier scenarios

  • First Data Generation - If you are new, this is the place to start
  • Multiple Records Per Column Value - How you can generate multiple records per set of columns
  • Foreign Keys Across Data Sources - Generate matching values across generated data sets
  • Data Validations - (Soon to document) Run data validations after generating data

Paid tier scenarios

  • Auto Generate From Data Connection - Automatically generating data from just defining data sources
  • Delete Generated Data - Delete the generated data whilst leaving other data
  • Generate Batch and Event Data - Generate matching batch and event data
"},{"location":"setup/guide/#data-sources","title":"Data Sources","text":"

Free tier data sources

  • Files (CSV, JSON, ORC, Parquet) - Generate data for files with separator (comma separated by default)
  • Files (Fixed width) - (Soon to document) A variant of CSV but with no separator
  • Postgres - JDBC Postgres tables

Paid tier data sources

  • Cassandra - Cassandra tables
  • Kafka - Kafka topics
  • Solace - Solace messages
  • Marquez - Generate data based on metadata in Marquez
  • OpenMetadata - Generate data based on metadata in OpenMetadata
  • HTTP - HTTP requests
  • MySql - (Soon to document) JDBC MySql tables
"},{"location":"setup/guide/#yaml-files","title":"YAML Files","text":""},{"location":"setup/guide/#base-concept","title":"Base Concept","text":"

The execution of the data generator is based on the concept of plans and tasks. A plan represent the set of tasks that need to be executed, along with other information that spans across tasks, such as foreign keys between data sources. A task represent the component(s) of a data source and its associated metadata so that it understands what the data should look like and how many steps (sub data sources) there are (i.e. tables in a database, topics in Kafka). Tasks can define one or more steps.

"},{"location":"setup/guide/#plan","title":"Plan","text":""},{"location":"setup/guide/#foreign-keys","title":"Foreign Keys","text":"

Define foreign keys across data sources in your plan to ensure generated data can match Link to associated task 1 Link to associated task 2

"},{"location":"setup/guide/#task","title":"Task","text":"Data Source Type Data Source Sample Task Notes Database Postgres Sample Database MySQL Sample Database Cassandra Sample File CSV Sample File JSON Sample Contains nested schemas and use of SQL for generated values File Parquet Sample Partition by year column Kafka Kafka Sample Specific base schema to be used, define headers, key, value, etc. JMS Solace Sample JSON formatted message HTTP PUT Sample JSON formatted PUT body"},{"location":"setup/guide/#configuration","title":"Configuration","text":"

Basic configuration

"},{"location":"setup/guide/#docker-compose","title":"Docker-compose","text":"

To see how it runs against different data sources, you can run using docker-compose and set DATA_SOURCE like below

./gradlew build\ncd docker\nDATA_SOURCE=postgres docker-compose up -d datacaterer\n

Can set it to one of the following:

  • postgres
  • mysql
  • cassandra
  • solace
  • kafka
  • http
"},{"location":"setup/guide/data-source/cassandra/","title":"Cassandra","text":"

Info

Writing data to Cassandra is a paid feature. Try the free trial here.

Creating a data generator for Cassandra. You will build a Docker image that will be able to populate data in Cassandra for the tables you configure.

"},{"location":"setup/guide/data-source/cassandra/#requirements","title":"Requirements","text":"
  • 20 minutes
  • Git
  • Gradle
  • Docker
  • Cassandra
"},{"location":"setup/guide/data-source/cassandra/#get-started","title":"Get Started","text":"

First, we will clone the data-caterer-example repo which will already have the base project setup required.

git clone git@github.com:pflooky/data-caterer-example.git\n

If you already have a Cassandra instance running, you can skip to this step.

"},{"location":"setup/guide/data-source/cassandra/#cassandra-setup","title":"Cassandra Setup","text":"

Next, let's make sure you have an instance of Cassandra up and running in your local environment. This will make it easy for us to iterate and check our changes.

cd docker\ndocker-compose up -d cassandra\n
"},{"location":"setup/guide/data-source/cassandra/#permissions","title":"Permissions","text":"

Let's make a new user that has the required permissions needed to push data into the Cassandra tables we want.

CQL Permission Statements 
GRANT INSERT ON <schema>.<table> TO data_caterer_user;\n

Following permissions are required when enabling configuration.enableGeneratePlanAndTasks(true) as it will gather metadata information about tables and columns from the below tables.

CQL Permission Statements 
GRANT SELECT ON system_schema.tables TO data_caterer_user;\nGRANT SELECT ON system_schema.columns TO data_caterer_user;\n
"},{"location":"setup/guide/data-source/cassandra/#plan-setup","title":"Plan Setup","text":"

Create a new Java or Scala class.

  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedCassandraJavaPlan.java
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedCassandraPlan.scala

Make sure your class extends PlanRun.

JavaScala 
import com.github.pflooky.datacaterer.java.api.PlanRun;\n\npublic class MyAdvancedCassandraJavaPlan extends PlanRun {\n}\n
import com.github.pflooky.datacaterer.api.PlanRun\n\nclass MyAdvancedCassandraPlan extends PlanRun {\n}\n

This class defines where we need to define all of our configurations for generating data. There are helper variables and methods defined to make it simple and easy to use.

"},{"location":"setup/guide/data-source/cassandra/#connection-configuration","title":"Connection Configuration","text":"

Within our class, we can start by defining the connection properties to connect to Cassandra.

JavaScala 
var accountTask = cassandra(\n    \"customer_cassandra\",   //name\n    \"localhost:9042\",       //url\n    \"cassandra\",            //username\n    \"cassandra\",            //password\n    Map.of()                //optional additional connection options\n)\n

Additional options such as SSL configuration, etc can be found here.

val accountTask = cassandra(\n    \"customer_cassandra\",   //name\n    \"localhost:9042\",       //url\n    \"cassandra\",            //username\n    \"cassandra\",            //password\n    Map()                   //optional additional connection options\n)\n

Additional options such as SSL configuration, etc can be found here.

"},{"location":"setup/guide/data-source/cassandra/#schema","title":"Schema","text":"

Let's create a task for inserting data into the account.accounts and account.account_status_history tables as defined underdocker/data/cql/customer.cql. This table should already be setup for you if you followed this step. We can check if the table is setup already via the following command:

docker exec host.docker.internal cqlsh -e 'describe account.accounts; describe account.account_status_history;'\n

Here we should see some output that looks like the below. This tells us what schema we need to follow when generating data. We need to define that alongside any metadata that is useful to add constraints on what are possible values the generated data should contain.

CREATE TABLE account.accounts (\n    account_id text PRIMARY KEY,\n    amount double,\n    created_by text,\n    name text,\n    open_time timestamp,\n    status text\n)...\n\nCREATE TABLE account.account_status_history (\n    account_id text,\n    eod_date date,\n    status text,\n    updated_by text,\n    updated_time timestamp,\n    PRIMARY KEY (account_id, eod_date)\n)...\n

Trimming the connection details to work with the docker-compose Cassandra, we have a base Cassandra connection to define the table and schema required. Let's define each field along with their corresponding data type. You will notice that the text fields do not have a data type defined. This is because the default data type is StringType which corresponds to text in Cassandra.

JavaScala 
{\n    var accountTask = cassandra(\"customer_cassandra\", \"host.docker.internal:9042\")\n            .table(\"account\", \"accounts\")\n            .schema(\n                    field().name(\"account_id\"),\n                    field().name(\"amount\").type(DoubleType.instance()),\n                    field().name(\"created_by\"),\n                    field().name(\"name\"),\n                    field().name(\"open_time\").type(TimestampType.instance()),\n                    field().name(\"status\")\n            );\n}\n
val accountTask = cassandra(\"customer_cassandra\", \"host.docker.internal:9042\")\n  .table(\"account\", \"accounts\")\n  .schema(\n    field.name(\"account_id\"),\n    field.name(\"amount\").`type`(DoubleType),\n    field.name(\"created_by\"),\n    field.name(\"name\"),\n    field.name(\"open_time\").`type`(TimestampType),\n    field.name(\"status\")\n  )\n
"},{"location":"setup/guide/data-source/cassandra/#field-metadata","title":"Field Metadata","text":"

We could stop here and generate random data for the accounts table. But wouldn't it be more useful if we produced data that is closer to the structure of the data that would come in production? We can do this by defining various metadata that add guidelines that the data generator will understand when generating data.

"},{"location":"setup/guide/data-source/cassandra/#account_id","title":"account_id","text":"

account_id follows a particular pattern that where it starts with ACC and has 8 digits after it. This can be defined via a regex like below. Alongside, we also mention that it is the primary key to prompt ensure that unique values are generated.

JavaScala 
field().name(\"account_id\").regex(\"ACC[0-9]{8}\").primaryKey(true),\n
field.name(\"account_id\").regex(\"ACC[0-9]{8}\").primaryKey(true),\n
"},{"location":"setup/guide/data-source/cassandra/#amount","title":"amount","text":"

amount the numbers shouldn't be too large, so we can define a min and max for the generated numbers to be between 1 and 1000.

JavaScala 
field().name(\"amount\").type(DoubleType.instance()).min(1).max(1000),\n
field.name(\"amount\").`type`(DoubleType).min(1).max(1000),\n
"},{"location":"setup/guide/data-source/cassandra/#name","title":"name","text":"

name is a string that also follows a certain pattern, so we could also define a regex but here we will choose to leverage the DataFaker library and create an expression to generate real looking name. All possible faker expressions can be found here

JavaScala 
field().name(\"name\").expression(\"#{Name.name}\"),\n
field.name(\"name\").expression(\"#{Name.name}\"),\n
"},{"location":"setup/guide/data-source/cassandra/#open_time","title":"open_time","text":"

open_time is a timestamp that we want to have a value greater than a specific date. We can define a min date by using java.sql.Date like below.

JavaScala 
field().name(\"open_time\").type(TimestampType.instance()).min(java.sql.Date.valueOf(\"2022-01-01\")),\n
field.name(\"open_time\").`type`(TimestampType).min(java.sql.Date.valueOf(\"2022-01-01\")),\n
"},{"location":"setup/guide/data-source/cassandra/#status","title":"status","text":"

status is a field that can only obtain one of four values, open, closed, suspended or pending.

JavaScala 
field().name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n
field.name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n
"},{"location":"setup/guide/data-source/cassandra/#created_by","title":"created_by","text":"

created_by is a field that is based on the status field where it follows the logic: if status is open or closed, then it is created_by eod else created_by event. This can be achieved by defining a SQL expression like below.

JavaScala 
field().name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n
field.name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n

Putting it all the fields together, our class should now look like this.

JavaScala 
var accountTask = cassandra(\"customer_cassandra\", \"host.docker.internal:9042\")\n        .table(\"account\", \"accounts\")\n        .schema(\n                field().name(\"account_id\").regex(\"ACC[0-9]{8}\").primaryKey(true),\n                field().name(\"amount\").type(DoubleType.instance()).min(1).max(1000),\n                field().name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n                field().name(\"name\").expression(\"#{Name.name}\"),\n                field().name(\"open_time\").type(TimestampType.instance()).min(java.sql.Date.valueOf(\"2022-01-01\")),\n                field().name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n        );\n
val accountTask = cassandra(\"customer_cassandra\", \"host.docker.internal:9042\")\n  .table(\"account\", \"accounts\")\n  .schema(\n    field.name(\"account_id\").primaryKey(true),\n    field.name(\"amount\").`type`(DoubleType).min(1).max(1000),\n    field.name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n    field.name(\"name\").expression(\"#{Name.name}\"),\n    field.name(\"open_time\").`type`(TimestampType).min(java.sql.Date.valueOf(\"2022-01-01\")),\n    field.name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n  )\n
"},{"location":"setup/guide/data-source/cassandra/#additional-configurations","title":"Additional Configurations","text":"

At the end of data generation, a report gets generated that summarises the actions it performed. We can control the output folder of that report via configurations. We will also enable the unique check to ensure any unique fields will have unique values generated.

JavaScala 
var config = configuration()\n        .generatedReportsFolderPath(\"/opt/app/data/report\")\n        .enableUniqueCheck(true);\n
val config = configuration\n  .generatedReportsFolderPath(\"/opt/app/data/report\")\n  .enableUniqueCheck(true)\n
"},{"location":"setup/guide/data-source/cassandra/#execute","title":"Execute","text":"

To tell Data Caterer that we want to run with the configurations along with the accountTask, we have to call execute . So our full plan run will look like this.

JavaScala 
public class MyAdvancedCassandraJavaPlan extends PlanRun {\n    {\n        var accountTask = cassandra(\"customer_cassandra\", \"host.docker.internal:9042\")\n                .table(\"account\", \"accounts\")\n                .schema(\n                        field().name(\"account_id\").regex(\"ACC[0-9]{8}\").primaryKey(true),\n                        field().name(\"amount\").type(DoubleType.instance()).min(1).max(1000),\n                        field().name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n                        field().name(\"name\").expression(\"#{Name.name}\"),\n                        field().name(\"open_time\").type(TimestampType.instance()).min(java.sql.Date.valueOf(\"2022-01-01\")),\n                        field().name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n                );\n\n        var config = configuration()\n                .generatedReportsFolderPath(\"/opt/app/data/report\")\n                .enableUniqueCheck(true);\n\n        execute(config, accountTask);\n    }\n}\n
class MyAdvancedCassandraPlan extends PlanRun {\n  val accountTask = cassandra(\"customer_cassandra\", \"host.docker.internal:9042\")\n    .table(\"account\", \"accounts\")\n    .schema(\n      field.name(\"account_id\").primaryKey(true),\n      field.name(\"amount\").`type`(DoubleType).min(1).max(1000),\n      field.name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n      field.name(\"name\").expression(\"#{Name.name}\"),\n      field.name(\"open_time\").`type`(TimestampType).min(java.sql.Date.valueOf(\"2022-01-01\")),\n      field.name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n    )\n\n  val config = configuration\n    .generatedReportsFolderPath(\"/opt/app/data/report\")\n    .enableUniqueCheck(true)\n\n  execute(config, accountTask)\n}\n
"},{"location":"setup/guide/data-source/cassandra/#run","title":"Run","text":"

Now we can run via the script ./run.sh that is in the top level directory of the data-caterer-example to run the class we just created.

./run.sh\n#input class MyAdvancedCassandraJavaPlan or MyAdvancedCassandraPlan\n#after completing\ndocker exec docker-cassandraserver-1 cqlsh -e 'select count(1) from account.accounts;select * from account.accounts limit 10;'\n

Your output should look like this.

 count\n-------\n  1000\n\n(1 rows)\n\nWarnings :\nAggregation query used without partition key\n\n\n account_id  | amount    | created_by         | name                   | open_time                       | status\n-------------+-----------+--------------------+------------------------+---------------------------------+-----------\n ACC13554145 | 917.00418 | zb CVvbBTTzitjo5fK |          Jan Sanford I | 2023-06-21 21:50:10.463000+0000 | suspended\n ACC19154140 |  46.99177 |             VH88H9 |       Clyde Bailey PhD | 2023-07-18 11:33:03.675000+0000 |      open\n ACC50587836 |  774.9872 |         GENANwPm t |           Sang Monahan | 2023-03-21 00:16:53.308000+0000 |    closed\n ACC67619387 | 452.86706 |       5msTpcBLStTH |         Jewell Gerlach | 2022-10-18 19:13:07.606000+0000 | suspended\n ACC69889784 |  14.69298 |           WDmOh7NT |          Dale Schulist | 2022-10-25 12:10:52.239000+0000 | suspended\n ACC41977254 |  51.26492 |          J8jAKzvj2 |           Norma Nienow | 2023-08-19 18:54:39.195000+0000 | suspended\n ACC40932912 | 349.68067 |   SLcJgKZdLp5ALMyg | Vincenzo Considine III | 2023-05-16 00:22:45.991000+0000 |    closed\n ACC20642011 | 658.40713 |          clyZRD4fI |  Lannie McLaughlin DDS | 2023-05-11 23:14:30.249000+0000 |      open\n ACC74962085 | 970.98218 |       ZLETTSnj4NpD |          Ima Jerde DVM | 2023-05-07 10:01:56.218000+0000 |   pending\n ACC72848439 | 481.64267 |                 cc |        Kyla Deckow DDS | 2023-08-16 13:28:23.362000+0000 | suspended\n\n(10 rows)\n

Also check the HTML report, found at docker/sample/report/index.html, that gets generated to get an overview of what was executed.

"},{"location":"setup/guide/data-source/http/","title":"HTTP Source","text":"

Info

Generating data based on OpenAPI/Swagger document and pushing to HTTP endpoint is a paid feature. Try the free trial here.

Creating a data generator based on an OpenAPI/Swagger document.

"},{"location":"setup/guide/data-source/http/#requirements","title":"Requirements","text":"
  • 10 minutes
  • Git
  • Gradle
  • Docker
"},{"location":"setup/guide/data-source/http/#get-started","title":"Get Started","text":"

First, we will clone the data-caterer-example repo which will already have the base project setup required.

git clone git@github.com:pflooky/data-caterer-example.git\n
"},{"location":"setup/guide/data-source/http/#http-setup","title":"HTTP Setup","text":"

We will be using the http-bin docker image to help simulate a service with HTTP endpoints.

Start it via:

cd docker\ndocker-compose up -d http\ndocker ps\n
"},{"location":"setup/guide/data-source/http/#plan-setup","title":"Plan Setup","text":"

Create a new Java or Scala class.

  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedHttpJavaPlanRun.java
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedHttpPlanRun.scala

Make sure your class extends PlanRun.

JavaScala 
import com.github.pflooky.datacaterer.java.api.PlanRun;\n...\n\npublic class MyAdvancedHttpJavaPlanRun extends PlanRun {\n    {\n        var conf = configuration().enableGeneratePlanAndTasks(true)\n            .generatedReportsFolderPath(\"/opt/app/data/report\");\n    }\n}\n
import com.github.pflooky.datacaterer.api.PlanRun\n...\n\nclass MyAdvancedHttpPlanRun extends PlanRun {\n  val conf = configuration.enableGeneratePlanAndTasks(true)\n    .generatedReportsFolderPath(\"/opt/app/data/report\")\n}\n

We will enable generate plan and tasks so that we can read from external sources for metadata and save the reports under a folder we can easily access.

"},{"location":"setup/guide/data-source/http/#schema","title":"Schema","text":"

We can point the schema of a data source to a OpenAPI/Swagger document or URL. For this example, we will use the OpenAPI document found under docker/mount/http/petstore.json in the data-caterer-example repo. This is a simplified version of the original OpenAPI spec that can be found here.

We have kept the following endpoints to test out:

  • GET /pets - get all pets
  • POST /pets - create a new pet
  • GET /pets/{id} - get a pet by id
  • DELETE /pets/{id} - delete a pet by id
JavaScala 
var httpTask = http(\"my_http\")\n        .schema(metadataSource().openApi(\"/opt/app/mount/http/petstore.json\"))\n        .count(count().records(2));\n
val httpTask = http(\"my_http\")\n  .schema(metadataSource.openApi(\"/opt/app/mount/http/petstore.json\"))\n  .count(count.records(2))\n

The above defines that the schema will come from an OpenAPI document found on the pathway defined. It will then generate 2 requests per request method and endpoint combination.

"},{"location":"setup/guide/data-source/http/#run","title":"Run","text":"

Let's try run and see what happens.

cd ..\n./run.sh\n#input class MyAdvancedHttpJavaPlanRun or MyAdvancedHttpPlanRun\n#after completing\ndocker logs -f docker-http-1\n

It should look something like this.

172.21.0.1 [06/Nov/2023:01:06:53 +0000] GET /anything/pets?tags%3DeXQxFUHVja+EYm%26limit%3D33895 HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:06:53 +0000] GET /anything/pets?tags%3DSXaFvAqwYGF%26tags%3DjdNRFONA%26limit%3D40975 HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:06:56 +0000] POST /anything/pets HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:06:56 +0000] POST /anything/pets HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:07:00 +0000] GET /anything/pets/kbH8D7rDuq HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:07:00 +0000] GET /anything/pets/REsa0tnu7dvekGDvxR HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:07:03 +0000] DELETE /anything/pets/EqrOr1dHFfKUjWb HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:07:03 +0000] DELETE /anything/pets/7WG7JHPaNxP HTTP/1.1 200 Host: host.docker.internal}\n

Looks like we have some data now. But we can do better and add some enhancements to it.

"},{"location":"setup/guide/data-source/http/#foreign-keys","title":"Foreign keys","text":"

The four different requests that get sent could have the same id passed across to each of them if we define a foreign key relationship. This will make it more realistic to a real life scenario as pets get created and queried by a particular id value. We note that the id value is first used when a pet is created in the body of the POST request. Then it gets used as a path parameter in the DELETE and GET requests.

To link them all together, we must follow a particular pattern when referring to request body, query parameter or path parameter columns.

HTTP Type Column Prefix Example Request Body bodyContent bodyContent.id Path Parameter pathParam pathParamid Query Parameter queryParam queryParamid

Also note, that when creating a foreign field definition for a HTTP data source, to refer to a specific endpoint and method, we have to follow the pattern of {http method}{http path}. For example, POST/pets. Let's apply this knowledge to link all the id values together.

JavaScala 
var myPlan = plan().addForeignKeyRelationship(\n        foreignField(\"my_http\", \"POST/pets\", \"bodyContent.id\"),\n        foreignField(\"my_http\", \"GET/pets/{id}\", \"pathParamid\"),\n        foreignField(\"my_http\", \"DELETE/pets/{id}\", \"pathParamid\")\n);\n\nexecute(myPlan, conf, httpTask);\n
val myPlan = plan.addForeignKeyRelationship(\n  foreignField(\"my_http\", \"POST/pets\", \"bodyContent.id\"),\n  foreignField(\"my_http\", \"GET/pets/{id}\", \"pathParamid\"),\n  foreignField(\"my_http\", \"DELETE/pets/{id}\", \"pathParamid\")\n)\n\nexecute(myPlan, conf, httpTask)\n

Let's test it out by running it again

./run.sh\n#input class MyAdvancedHttpJavaPlanRun or MyAdvancedHttpPlanRun\ndocker logs -f docker-http-1\n
172.21.0.1 [06/Nov/2023:01:33:59 +0000] GET /anything/pets?limit%3D45971 HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:34:00 +0000] GET /anything/pets?limit%3D62015 HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:34:04 +0000] POST /anything/pets HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:34:05 +0000] POST /anything/pets HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:34:09 +0000] DELETE /anything/pets/5e HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:34:09 +0000] DELETE /anything/pets/IHPm2 HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:34:14 +0000] GET /anything/pets/IHPm2 HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:34:14 +0000] GET /anything/pets/5e HTTP/1.1 200 Host: host.docker.internal}\n

Now we have the same id values being produced across the POST, DELETE and GET requests! What if we knew that the id values should follow a particular pattern?

"},{"location":"setup/guide/data-source/http/#custom-metadata","title":"Custom metadata","text":"

So given that we have defined a foreign key where the root of the foreign key values is from the POST request, we can update the metadata of the id column for the POST request and it will proliferate to the other endpoints as well. Given the id column is a nested column as noted in the foreign key, we can alter its metadata via the following:

JavaScala 
var httpTask = http(\"my_http\")\n        .schema(metadataSource().openApi(\"/opt/app/mount/http/petstore.json\"))\n        .schema(field().name(\"bodyContent\").schema(field().name(\"id\").regex(\"ID[0-9]{8}\")))\n        .count(count().records(2));\n
val httpTask = http(\"my_http\")\n  .schema(metadataSource.openApi(\"/opt/app/mount/http/petstore.json\"))\n  .schema(field.name(\"bodyContent\").schema(field.name(\"id\").regex(\"ID[0-9]{8}\")))\n  .count(count.records(2))\n

We first get the column bodyContent, then get the nested schema and get the column id and add metadata stating that id should follow the patter ID[0-9]{8}.

Let's try run again, and hopefully we should see some proper ID values.

./run.sh\n#input class MyAdvancedHttpJavaPlanRun or MyAdvancedHttpPlanRun\ndocker logs -f docker-http-1\n
172.21.0.1 [06/Nov/2023:01:45:45 +0000] GET /anything/pets?tags%3D10fWnNoDz%26limit%3D66804 HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:45:46 +0000] GET /anything/pets?tags%3DhyO6mI8LZUUpS HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:45:50 +0000] POST /anything/pets HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:45:51 +0000] POST /anything/pets HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:45:52 +0000] DELETE /anything/pets/ID55185420 HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:45:52 +0000] DELETE /anything/pets/ID20618951 HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:45:57 +0000] GET /anything/pets/ID55185420 HTTP/1.1 200 Host: host.docker.internal}\n172.21.0.1 [06/Nov/2023:01:45:57 +0000] GET /anything/pets/ID20618951 HTTP/1.1 200 Host: host.docker.internal}\n

Great! Now we have replicated a production-like flow of HTTP requests.

"},{"location":"setup/guide/data-source/http/#ordering","title":"Ordering","text":"

If you wanted to change the ordering of the requests, you can alter the order from within the OpenAPI/Swagger document.

"},{"location":"setup/guide/data-source/http/#rows-per-second","title":"Rows per second","text":"

By default, Data Caterer will push requests per method and endpoint at a rate of around 5 requests per second. If you want to alter this value, you can do so via the below configuration.

JavaScala 
var httpTask = http(\"my_http\")\n        ...\n        .count(count().records(2));\n
val httpTask = http(\"my_http\")\n  ...\n  .count(count.records(2))\n

Check out the full example under AdvancedHttpPlanRun in the example repo.

"},{"location":"setup/guide/data-source/kafka/","title":"Kafka","text":"

Info

Writing data to Kafka is a paid feature. Try the free trial here.

Creating a data generator for Kafka. You will build a Docker image that will be able to populate data in kafka for the topics you configure.

"},{"location":"setup/guide/data-source/kafka/#requirements","title":"Requirements","text":"
  • 20 minutes
  • Git
  • Gradle
  • Docker
  • Kafka
"},{"location":"setup/guide/data-source/kafka/#get-started","title":"Get Started","text":"

First, we will clone the data-caterer-example repo which will already have the base project setup required.

git clone git@github.com:pflooky/data-caterer-example.git\n

If you already have a Kafka instance running, you can skip to this step.

"},{"location":"setup/guide/data-source/kafka/#kafka-setup","title":"Kafka Setup","text":"

Next, let's make sure you have an instance of Kafka up and running in your local environment. This will make it easy for us to iterate and check our changes.

cd docker\ndocker-compose up -d kafka\n
"},{"location":"setup/guide/data-source/kafka/#plan-setup","title":"Plan Setup","text":"

Create a new Java or Scala class.

  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedKafkaJavaPlan.java
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedKafkaPlan.scala

Make sure your class extends PlanRun.

JavaScala 
import com.github.pflooky.datacaterer.java.api.PlanRun;\n\npublic class MyAdvancedKafkaJavaPlan extends PlanRun {\n}\n
import com.github.pflooky.datacaterer.api.PlanRun\n\nclass MyAdvancedKafkaPlan extends PlanRun {\n}\n

This class defines where we need to define all of our configurations for generating data. There are helper variables and methods defined to make it simple and easy to use.

"},{"location":"setup/guide/data-source/kafka/#connection-configuration","title":"Connection Configuration","text":"

Within our class, we can start by defining the connection properties to connect to Kafka.

JavaScala 
var accountTask = kafka(\n    \"my_kafka\",       //name\n    \"localhost:9092\", //url\n    Map.of()          //optional additional connection options\n);\n

Additional options can be found here.

val accountTask = kafka(\n    \"my_kafka\",       //name\n    \"localhost:9092\", //url\n    Map()             //optional additional connection options\n)\n

Additional options can be found here.

"},{"location":"setup/guide/data-source/kafka/#schema","title":"Schema","text":"

Let's create a task for inserting data into the account-topic that is already defined underdocker/data/kafka/setup_kafka.sh. This topic should already be setup for you if you followed this step. We can check if the topic is set up already via the following command:

docker exec docker-kafkaserver-1 kafka-topics --bootstrap-server localhost:9092 --list\n

Trimming the connection details to work with the docker-compose Kafka, we have a base Kafka connection to define the topic we will publish to. Let's define each field along with their corresponding data type. You will notice that the text fields do not have a data type defined. This is because the default data type is StringType.

JavaScala 
{\n    var kafkaTask = kafka(\"my_kafka\", \"kafkaserver:29092\")\n            .topic(\"account-topic\")\n            .schema(\n                    field().name(\"key\").sql(\"content.account_id\"),\n                    field().name(\"value\").sql(\"TO_JSON(content)\"),\n                    //field().name(\"partition\").type(IntegerType.instance()),  can define partition here\n                    field().name(\"headers\")\n                            .type(ArrayType.instance())\n                            .sql(\n                                    \"ARRAY(\" +\n                                            \"NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8')),\" +\n                                            \"NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))\" +\n                                            \")\"\n                            ),\n                    field().name(\"content\")\n                            .schema(\n                                    field().name(\"account_id\").regex(\"ACC[0-9]{8}\"),\n                                    field().name(\"year\").type(IntegerType.instance()),\n                                    field().name(\"amount\").type(DoubleType.instance()),\n                                    field().name(\"details\")\n                                            .schema(\n                                                    field().name(\"name\").expression(\"#{Name.name}\"),\n                                                    field().name(\"first_txn_date\").type(DateType.instance()).sql(\"ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)\"),\n                                                    field().name(\"updated_by\")\n                                                            .schema(\n                                                                    field().name(\"user\"),\n                                                                    field().name(\"time\").type(TimestampType.instance())\n                                                            )\n                                            ),\n                                    field().name(\"transactions\").type(ArrayType.instance())\n                                            .schema(\n                                                    field().name(\"txn_date\").type(DateType.instance()).min(Date.valueOf(\"2021-01-01\")).max(\"2021-12-31\"),\n                                                    field().name(\"amount\").type(DoubleType.instance())\n                                            )\n                            ),\n                    field().name(\"tmp_year\").sql(\"content.year\").omit(true),\n                    field().name(\"tmp_name\").sql(\"content.details.name\").omit(true)\n            )\n}\n
val kafkaTask = kafka(\"my_kafka\", \"kafkaserver:29092\")\n  .topic(\"account-topic\")\n  .schema(\n    field.name(\"key\").sql(\"content.account_id\"),\n    field.name(\"value\").sql(\"TO_JSON(content)\"),\n    //field.name(\"partition\").type(IntegerType),  can define partition here\n    field.name(\"headers\")\n      .`type`(ArrayType)\n      .sql(\n        \"\"\"ARRAY(\n          |  NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8')),\n          |  NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))\n          |)\"\"\".stripMargin\n      ),\n    field.name(\"content\")\n      .schema(\n        field.name(\"account_id\").regex(\"ACC[0-9]{8}\"),\n        field.name(\"year\").`type`(IntegerType).min(2021).max(2023),\n        field.name(\"amount\").`type`(DoubleType),\n        field.name(\"details\")\n          .schema(\n            field.name(\"name\").expression(\"#{Name.name}\"),\n            field.name(\"first_txn_date\").`type`(DateType).sql(\"ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)\"),\n            field.name(\"updated_by\")\n              .schema(\n                field.name(\"user\"),\n                field.name(\"time\").`type`(TimestampType),\n              ),\n          ),\n        field.name(\"transactions\").`type`(ArrayType)\n          .schema(\n            field.name(\"txn_date\").`type`(DateType).min(Date.valueOf(\"2021-01-01\")).max(\"2021-12-31\"),\n            field.name(\"amount\").`type`(DoubleType),\n          )\n      ),\n    field.name(\"tmp_year\").sql(\"content.year\").omit(true),\n    field.name(\"tmp_name\").sql(\"content.details.name\").omit(true)\n  )\n
"},{"location":"setup/guide/data-source/kafka/#fields","title":"Fields","text":"

The schema defined for Kafka has a format that needs to be followed as noted above. Specifically, the required fields are: - value

Whilst, the other fields are optional: - key - partition - headers

"},{"location":"setup/guide/data-source/kafka/#headers","title":"headers","text":"

headers follows a particular pattern that where it is of type array<struct<key: string,value: binary>>. To be able to generate data for this data type, we need to use an SQL expression like the one below. You will notice that in the value part, it refers to content.account_id where content is another field defined at the top level of the schema. This allows you to reference other values that have already been generated.

JavaScala 
field().name(\"headers\")\n        .type(ArrayType.instance())\n        .sql(\n                \"ARRAY(\" +\n                        \"NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8')),\" +\n                        \"NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))\" +\n                        \")\"\n        )\n
field.name(\"headers\")\n  .`type`(ArrayType)\n  .sql(\n    \"\"\"ARRAY(\n      |  NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8')),\n      |  NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))\n      |)\"\"\".stripMargin\n  )\n
"},{"location":"setup/guide/data-source/kafka/#transactions","title":"transactions","text":"

transactions is an array that contains an inner structure of txn_date and amount. The size of the array generated can be controlled via arrayMinLength and arrayMaxLength.

JavaScala 
field().name(\"transactions\").type(ArrayType.instance())\n        .schema(\n                field().name(\"txn_date\").type(DateType.instance()).min(Date.valueOf(\"2021-01-01\")).max(\"2021-12-31\"),\n                field().name(\"amount\").type(DoubleType.instance())\n        )\n
field.name(\"transactions\").`type`(ArrayType)\n  .schema(\n    field.name(\"txn_date\").`type`(DateType).min(Date.valueOf(\"2021-01-01\")).max(\"2021-12-31\"),\n    field.name(\"amount\").`type`(DoubleType),\n  )\n
"},{"location":"setup/guide/data-source/kafka/#details","title":"details","text":"

details is another example of a nested schema structure where it also has a nested structure itself in updated_by. One thing to note here is the first_txn_date field has a reference to the content.transactions array where it will sort the array by txn_date and get the first element.

JavaScala 
field().name(\"details\")\n        .schema(\n                field().name(\"name\").expression(\"#{Name.name}\"),\n                field().name(\"first_txn_date\").type(DateType.instance()).sql(\"ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)\"),\n                field().name(\"updated_by\")\n                        .schema(\n                                field().name(\"user\"),\n                                field().name(\"time\").type(TimestampType.instance())\n                        )\n        )\n
field.name(\"details\")\n  .schema(\n    field.name(\"name\").expression(\"#{Name.name}\"),\n    field.name(\"first_txn_date\").`type`(DateType).sql(\"ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)\"),\n    field.name(\"updated_by\")\n      .schema(\n        field.name(\"user\"),\n        field.name(\"time\").`type`(TimestampType),\n      ),\n  )\n
"},{"location":"setup/guide/data-source/kafka/#additional-configurations","title":"Additional Configurations","text":"

At the end of data generation, a report gets generated that summarises the actions it performed. We can control the output folder of that report via configurations.

JavaScala 
var config = configuration()\n        .generatedReportsFolderPath(\"/opt/app/data/report\");\n
val config = configuration\n  .generatedReportsFolderPath(\"/opt/app/data/report\")\n
"},{"location":"setup/guide/data-source/kafka/#execute","title":"Execute","text":"

To tell Data Caterer that we want to run with the configurations along with the kafkaTask, we have to call execute .

"},{"location":"setup/guide/data-source/kafka/#run","title":"Run","text":"

Now we can run via the script ./run.sh that is in the top level directory of the data-caterer-example to run the class we just created.

./run.sh\n#input class AdvancedKafkaJavaPlanRun or AdvancedKafkaPlanRun\n#after completing\ndocker exec docker-kafkaserver-1 kafka-console-consumer --bootstrap-server localhost:9092 --topic account-topic --from-beginning\n

Your output should look like this.

{\"account_id\":\"ACC56292178\",\"year\":2022,\"amount\":18338.627721151555,\"details\":{\"name\":\"Isaias Reilly\",\"first_txn_date\":\"2021-01-22\",\"updated_by\":{\"user\":\"FgYXbKDWdhHVc3\",\"time\":\"2022-12-30T13:49:07.309Z\"}},\"transactions\":[{\"txn_date\":\"2021-01-22\",\"amount\":30556.52125487579},{\"txn_date\":\"2021-10-29\",\"amount\":39372.302259554635},{\"txn_date\":\"2021-10-29\",\"amount\":61887.31389495968}]}\n{\"account_id\":\"ACC37729457\",\"year\":2022,\"amount\":96885.31758764731,\"details\":{\"name\":\"Randell Witting\",\"first_txn_date\":\"2021-06-30\",\"updated_by\":{\"user\":\"HCKYEBHN8AJ3TB\",\"time\":\"2022-12-02T02:05:01.144Z\"}},\"transactions\":[{\"txn_date\":\"2021-06-30\",\"amount\":98042.09647765031},{\"txn_date\":\"2021-10-06\",\"amount\":41191.43564742036},{\"txn_date\":\"2021-11-16\",\"amount\":78852.08184809204},{\"txn_date\":\"2021-10-09\",\"amount\":13747.157653571106}]}\n{\"account_id\":\"ACC23127317\",\"year\":2023,\"amount\":81164.49304198896,\"details\":{\"name\":\"Jed Wisozk\",\"updated_by\":{\"user\":\"9MBFZZ\",\"time\":\"2023-07-12T05:56:52.397Z\"}},\"transactions\":[]}\n

Also check the HTML report, found at docker/sample/report/index.html, that gets generated to get an overview of what was executed.

"},{"location":"setup/guide/data-source/marquez-metadata-source/","title":"Metadata Source","text":"

Info

Generating data based on an external metadata source is a paid feature. Try the free trial here.

Creating a data generator for Postgres tables and CSV file based on metadata stored in Marquez ( follows OpenLineage API).

"},{"location":"setup/guide/data-source/marquez-metadata-source/#requirements","title":"Requirements","text":"
  • 10 minutes
  • Git
  • Gradle
  • Docker
"},{"location":"setup/guide/data-source/marquez-metadata-source/#get-started","title":"Get Started","text":"

First, we will clone the data-caterer-example repo which will already have the base project setup required.

git clone git@github.com:pflooky/data-caterer-example.git\n
"},{"location":"setup/guide/data-source/marquez-metadata-source/#marquez-setup","title":"Marquez Setup","text":"

You can follow the README found here to help with setting up Marquez in your local environment. This comes with an instance of Postgres which we will also be using as a data store for generated data.

The command that was run for this example to help with setup of dummy data was ./docker/up.sh -a 5001 -m 5002 --seed.

Check that the following url shows some data like below once you click on food_delivery from the ns drop down in the top right corner.

"},{"location":"setup/guide/data-source/marquez-metadata-source/#postgres-setup","title":"Postgres Setup","text":"

Since we will also be using the Marquez Postgres instance as a data source, we will set up a separate database to store the generated data in via:

docker exec marquez-db psql -Upostgres -c 'CREATE DATABASE food_delivery'\n
"},{"location":"setup/guide/data-source/marquez-metadata-source/#plan-setup","title":"Plan Setup","text":"

Create a new Java or Scala class.

  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedMetadataSourceJavaPlanRun.java
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedMetadataSourcePlanRun.scala

Make sure your class extends PlanRun.

JavaScala 
import com.github.pflooky.datacaterer.java.api.PlanRun;\n...\n\npublic class MyAdvancedMetadataSourceJavaPlanRun extends PlanRun {\n    {\n        var conf = configuration().enableGeneratePlanAndTasks(true)\n            .generatedReportsFolderPath(\"/opt/app/data/report\");\n    }\n}\n
import com.github.pflooky.datacaterer.api.PlanRun\n...\n\nclass MyAdvancedMetadataSourcePlanRun extends PlanRun {\n  val conf = configuration.enableGeneratePlanAndTasks(true)\n    .generatedReportsFolderPath(\"/opt/app/data/report\")\n}\n

We will enable generate plan and tasks so that we can read from external sources for metadata and save the reports under a folder we can easily access.

"},{"location":"setup/guide/data-source/marquez-metadata-source/#schema","title":"Schema","text":"

We can point the schema of a data source to our Marquez instance. For the Postgres data source, we will point to a namespace, which in Marquez or OpenLineage, represents a set of datasets. For the CSV data source, we will point to a specific namespace and dataset.

"},{"location":"setup/guide/data-source/marquez-metadata-source/#single-schema","title":"Single Schema","text":"JavaScala 
var csvTask = csv(\"my_csv\", \"/tmp/data/csv\", Map.of(\"saveMode\", \"overwrite\", \"header\", \"true\"))\n        .schema(metadataSource().marquez(\"http://localhost:5001\", \"food_delivery\", \"public.delivery_7_days\"))\n        .count(count().records(10));\n
val csvTask = csv(\"my_csv\", \"/tmp/data/csv\", Map(\"saveMode\" -> \"overwrite\", \"header\" -> \"true\"))\n  .schema(metadataSource.marquez(\"http://localhost:5001\", \"food_delivery\", \"public.delivery_7_days\"))\n  .count(count.records(10))\n

The above defines that the schema will come from Marquez, which is a type of metadata source that contains information about schemas. Specifically, it points to the food_delivery namespace and public.categories dataset to retrieve the schema information from.

"},{"location":"setup/guide/data-source/marquez-metadata-source/#multiple-schemas","title":"Multiple Schemas","text":"JavaScala 
var postgresTask = postgres(\"my_postgres\", \"jdbc:postgresql://host.docker.internal:5432/food_delivery\", \"postgres\", \"password\", Map.of())\n    .schema(metadataSource().marquez(\"http://host.docker.internal:5001\", \"food_delivery\"))\n    .count(count().records(10));\n
val postgresTask = postgres(\"my_postgres\", \"jdbc:postgresql://host.docker.internal:5432/food_delivery\", \"postgres\", \"password\")\n  .schema(metadataSource.marquez(\"http://host.docker.internal:5001\", \"food_delivery\"))\n  .count(count.records(10))\n

We now have pointed this Postgres instance to produce multiple schemas that are defined under the food_delivery namespace. Also note that we are using database food_delivery in Postgres to push our generated data to, and we have set the number of records per sub data source (in this case, per table) to be 10.

"},{"location":"setup/guide/data-source/marquez-metadata-source/#run","title":"Run","text":"

Let's try run and see what happens.

cd ..\n./run.sh\n#input class MyAdvancedMetadataSourceJavaPlanRun or MyAdvancedMetadataSourcePlanRun\n#after completing\ndocker exec marquez-db psql -Upostgres -d food_delivery -c 'SELECT * FROM public.delivery_7_days'\n

It should look something like this.

 order_id |     order_placed_on     |   order_dispatched_on   |   order_delivered_on    |         customer_email         |                     customer_address                     | menu_id | restaurant_id |                        restaurant_address\n   | menu_item_id | category_id | discount_id | city_id | driver_id\n----------+-------------------------+-------------------------+-------------------------+--------------------------------+----------------------------------------------------------+---------+---------------+---------------------------------------------------------------\n---+--------------+-------------+-------------+---------+-----------\n    38736 | 2023-02-05 06:05:23.755 | 2023-09-08 04:29:10.878 | 2023-09-03 23:58:34.285 | april.skiles@hotmail.com       | 5018 Lang Dam, Gaylordfurt, MO 35172                     |   59841 |         30971 | Suite 439 51366 Bartoletti Plains, West Lashawndamouth, CA 242\n42 |        55697 |       36370 |       21574 |   88022 |     16569\n     4376 | 2022-12-19 14:39:53.442 | 2023-08-30 07:40:06.948 | 2023-03-15 20:38:26.11  | adelina.balistreri@hotmail.com | Apt. 340 9146 Novella Motorway, East Troyhaven, UT 34773 |   66195 |         42765 | Suite 670 8956 Rob Fork, Rennershire, CA 04524\n   |        26516 |       81335 |       87615 |   27433 |     45649\n    11083 | 2022-10-30 12:46:38.692 | 2023-06-02 13:05:52.493 | 2022-11-27 18:38:07.873 | johnny.gleason@gmail.com       | Apt. 385 99701 Lemke Place, New Irvin, RI 73305          |   66427 |         44438 | 1309 Danny Cape, Weimanntown, AL 15865\n   |        41686 |       36508 |       34498 |   24191 |     92405\n    58759 | 2023-07-26 14:32:30.883 | 2022-12-25 11:04:08.561 | 2023-04-21 17:43:05.86  | isabelle.ohara@hotmail.com     | 2225 Evie Lane, South Ardella, SD 90805                  |   27106 |         25287 | Suite 678 3731 Dovie Park, Port Luigi, ID 08250\n   |        94205 |       66207 |       81051 |   52553 |     27483\n

You can also try query some other tables. Let's also check what is in the CSV file.

$ head docker/sample/csv/part-0000*\nmenu_item_id,category_id,discount_id,city_id,driver_id,order_id,order_placed_on,order_dispatched_on,order_delivered_on,customer_email,customer_address,menu_id,restaurant_id,restaurant_address\n72248,37098,80135,45888,5036,11090,2023-09-20T05:33:08.036+08:00,2023-05-16T23:10:57.119+08:00,2023-05-01T22:02:23.272+08:00,demetrice.rohan@hotmail.com,\"406 Harmony Rue, Wisozkburgh, MD 12282\",33762,9042,\"Apt. 751 0796 Ellan Flats, Lake Chetville, WI 81957\"\n41644,40029,48565,83373,89919,58359,2023-04-18T06:28:26.194+08:00,2022-10-15T18:17:48.998+08:00,2023-02-06T17:02:04.104+08:00,joannie.okuneva@yahoo.com,\"Suite 889 022 Susan Lane, Zemlakport, OR 56996\",27467,6216,\"Suite 016 286 Derick Grove, Dooleytown, NY 14664\"\n49299,53699,79675,40821,61764,72234,2023-07-16T21:33:48.739+08:00,2023-02-14T21:23:10.265+08:00,2023-09-18T02:08:51.433+08:00,ina.heller@yahoo.com,\"Suite 600 86844 Heller Island, New Celestinestad, DE 42622\",48002,12462,\"5418 Okuneva Mountain, East Blairchester, MN 04060\"\n83197,86141,11085,29944,81164,65382,2023-01-20T06:08:25.981+08:00,2023-01-11T13:24:32.968+08:00,2023-09-09T02:30:16.890+08:00,lakisha.bashirian@yahoo.com,\"Suite 938 534 Theodore Lock, Port Caitlynland, LA 67308\",69109,47727,\"4464 Stewart Tunnel, Marguritemouth, AR 56791\"\n

Looks like we have some data now. But we can do better and add some enhancements to it.

What if we wanted the same records in Postgres public.delivery_7_days to also show up in the CSV file? That's where we can use a foreign key definition.

"},{"location":"setup/guide/data-source/marquez-metadata-source/#foreign-key","title":"Foreign Key","text":"

We can take a look at the report (under docker/sample/report/index.html) to see what we need to do to create the foreign key. From the overview, you should see under Tasks there is a my_postgres task which has food_delivery_public.delivery_7_days as a step. Click on the link for food_delivery_public.delivery_7_days and it will take us to a page where we can find out about the columns used in this table. Click on the Fields button on the far right to see.

We can copy all of a subset of fields that we want matched across the CSV file and Postgres. For this example, we will take all the fields.

JavaScala 
var myPlan = plan().addForeignKeyRelationship(\n        postgresTask, List.of(\"key\", \"tmp_year\", \"tmp_name\", \"value\"),\n        List.of(Map.entry(csvTask, List.of(\"account_number\", \"year\", \"name\", \"payload\")))\n);\n\nvar conf = ...\n\nexecute(myPlan, conf, postgresTask, csvTask);\n
val foreignCols = List(\"order_id\", \"order_placed_on\", \"order_dispatched_on\", \"order_delivered_on\", \"customer_email\",\n  \"customer_address\", \"menu_id\", \"restaurant_id\", \"restaurant_address\", \"menu_item_id\", \"category_id\", \"discount_id\",\n  \"city_id\", \"driver_id\")\n\nval myPlan = plan.addForeignKeyRelationships(\n  csvTask, foreignCols,\n  List(foreignField(postgresTask, \"food_delivery_public.delivery_7_days\", foreignCols))\n)\n\nval conf = ...\n\nexecute(myPlan, conf, postgresTask, csvTask)\n

Notice how we have defined the csvTask and foreignCols as the main foreign key but for postgresTask, we had to define it as a foreignField. This is because postgresTask has multiple tables within it, and we only want to define our foreign key with respect to the public.delivery_7_days table. We use the step name (can be seen from the report) to specify the table to target.

To test this out, we will truncate the public.delivery_7_days table in Postgres first, and then try run again.

docker exec marquez-db psql -Upostgres -d food_delivery -c 'TRUNCATE public.delivery_7_days'\n./run.sh\n#input class MyAdvancedMetadataSourceJavaPlanRun or MyAdvancedMetadataSourcePlanRun\ndocker exec marquez-db psql -Upostgres -d food_delivery -c 'SELECT * FROM public.delivery_7_days'\n
 order_id |     order_placed_on     |   order_dispatched_on   |   order_delivered_on    |        customer_email        |\n       customer_address                     | menu_id | restaurant_id |                   restaurant_address                   | menu\n_item_id | category_id | discount_id | city_id | driver_id\n----------+-------------------------+-------------------------+-------------------------+------------------------------+-------------\n--------------------------------------------+---------+---------------+--------------------------------------------------------+-----\n---------+-------------+-------------+---------+-----------\n    53333 | 2022-10-15 08:40:23.394 | 2023-01-23 09:42:48.397 | 2023-08-12 08:50:52.397 | normand.aufderhar@gmail.com  | Apt. 036 449\n27 Wilderman Forge, Marvinchester, CT 15952 |   40412 |         70130 | Suite 146 98176 Schaden Village, Grahammouth, SD 12354 |\n   90141 |       44210 |       83966 |   78614 |     77449\n

Let's grab the first email from the Postgres table and check whether the same record exists in the CSV file.

$ cat docker/sample/csv/part-0000* | grep normand.aufderhar\n90141,44210,83966,78614,77449,53333,2022-10-15T08:40:23.394+08:00,2023-01-23T09:42:48.397+08:00,2023-08-12T08:50:52.397+08:00,normand.aufderhar@gmail.com,\"Apt. 036 44927 Wilderman Forge, Marvinchester, CT 15952\",40412,70130,\"Suite 146 98176 Schaden Village, Grahammouth, SD 12354\"\n

Great! Now we have the ability to get schema information from an external source, add our own foreign keys and generate data.

Check out the full example under AdvancedMetadataSourcePlanRun in the example repo.

"},{"location":"setup/guide/data-source/open-metadata-source/","title":"OpenMetadata Source","text":"

Info

Generating data based on an external metadata source is a paid feature. Try the free trial here.

Creating a data generator for a JSON file based on metadata stored in OpenMetadata.

"},{"location":"setup/guide/data-source/open-metadata-source/#requirements","title":"Requirements","text":"
  • 10 minutes
  • Git
  • Gradle
  • Docker
"},{"location":"setup/guide/data-source/open-metadata-source/#get-started","title":"Get Started","text":"

First, we will clone the data-caterer-example repo which will already have the base project setup required.

git clone git@github.com:pflooky/data-caterer-example.git\n
"},{"location":"setup/guide/data-source/open-metadata-source/#openmetadata-setup","title":"OpenMetadata Setup","text":"

You can follow the local docker setup found here to help with setting up OpenMetadata in your local environment.

If that page becomes outdated or the link doesn't work, below are the commands I used to run it:

mkdir openmetadata-docker && cd openmetadata-docker\ncurl -sL https://github.com/open-metadata/OpenMetadata/releases/download/1.2.0-release/docker-compose.yml > docker-compose.yml\ndocker compose -f docker-compose.yml up --detach\n

Check that the following url works and login with admin:admin. Then you should see some data like below:

"},{"location":"setup/guide/data-source/open-metadata-source/#plan-setup","title":"Plan Setup","text":"

Create a new Java or Scala class.

  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedOpenMetadataSourceJavaPlanRun.java
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedOpenMetadataSourcePlanRun.scala

Make sure your class extends PlanRun.

JavaScala 
import com.github.pflooky.datacaterer.java.api.PlanRun;\n...\n\npublic class MyAdvancedOpenMetadataSourceJavaPlanRun extends PlanRun {\n    {\n        var conf = configuration().enableGeneratePlanAndTasks(true)\n            .generatedReportsFolderPath(\"/opt/app/data/report\");\n    }\n}\n
import com.github.pflooky.datacaterer.api.PlanRun\n...\n\nclass MyAdvancedOpenMetadataSourcePlanRun extends PlanRun {\n  val conf = configuration.enableGeneratePlanAndTasks(true)\n    .generatedReportsFolderPath(\"/opt/app/data/report\")\n}\n

We will enable generate plan and tasks so that we can read from external sources for metadata and save the reports under a folder we can easily access.

"},{"location":"setup/guide/data-source/open-metadata-source/#schema","title":"Schema","text":"

We can point the schema of a data source to our OpenMetadata instance. We will use a JSON data source so that we can show how nested data types are handled and how we could customise it.

"},{"location":"setup/guide/data-source/open-metadata-source/#single-schema","title":"Single Schema","text":"JavaScala 
import com.github.pflooky.datacaterer.api.model.Constants;\n...\n\nvar jsonTask = json(\"my_json\", \"/opt/app/data/json\", Map.of(\"saveMode\", \"overwrite\"))\n        .schema(metadataSource().openMetadataJava(\n            \"http://localhost:8585/api\",                                                              //url\n            Constants.OPEN_METADATA_AUTH_TYPE_OPEN_METADATA(),                                        //auth type\n            Map.of(                                                                                   //additional options (including auth options)\n                Constants.OPEN_METADATA_JWT_TOKEN(), \"abc123\",                                        //get from settings/bots/ingestion-bot\n                Constants.OPEN_METADATA_TABLE_FQN(), \"sample_data.ecommerce_db.shopify.raw_customer\"  //table fully qualified name\n            )\n        ))\n        .count(count().records(10));\n
import com.github.pflooky.datacaterer.api.model.Constants.{OPEN_METADATA_AUTH_TYPE_OPEN_METADATA, OPEN_METADATA_JWT_TOKEN, OPEN_METADATA_TABLE_FQN, SAVE_MODE}\n...\n\nval jsonTask = json(\"my_json\", \"/opt/app/data/json\", Map(\"saveMode\" -> \"overwrite\"))\n  .schema(metadataSource.openMetadata(\n    \"http://localhost:8585/api\",                                                  //url\n    OPEN_METADATA_AUTH_TYPE_OPEN_METADATA,                                        //auth type\n    Map(                                                                          //additional options (including auth options)\n      OPEN_METADATA_JWT_TOKEN -> \"abc123\",                                        //get from settings/bots/ingestion-bot\n      OPEN_METADATA_TABLE_FQN -> \"sample_data.ecommerce_db.shopify.raw_customer\"  //table fully qualified name\n    )\n  ))\n  .count(count.records(10))\n

The above defines that the schema will come from OpenMetadata, which is a type of metadata source that contains information about schemas. Specifically, it points to the sample_data.ecommerce_db.shopify.raw_customer table. You can check out the schema here to see what it looks like.

"},{"location":"setup/guide/data-source/open-metadata-source/#run","title":"Run","text":"

Let's try run and see what happens.

cd ..\n./run.sh\n#input class MyAdvancedOpenMetadataSourceJavaPlanRun or MyAdvancedOpenMetadataSourcePlanRun\n#after completing\ncat docker/sample/json/part-00000-*\n

It should look something like this.

{\n  \"comments\": \"Mh6jqpD5e4M\",\n  \"creditcard\": \"6771839575926717\",\n  \"membership\": \"Za3wCQUl9E  EJj712\",\n  \"orders\": [\n    {\n      \"product_id\": \"Aa6NG0hxfHVq\",\n      \"price\": 16139,\n      \"onsale\": false,\n      \"tax\": 58134,\n      \"weight\": 40734,\n      \"others\": 45813,\n      \"vendor\": \"Kh\"\n    },\n    {\n      \"product_id\": \"zbHBY \",\n      \"price\": 17903,\n      \"onsale\": false,\n      \"tax\": 39526,\n      \"weight\": 9346,\n      \"others\": 52035,\n      \"vendor\": \"jbkbnXAa\"\n    },\n    {\n      \"product_id\": \"5qs3gakppd7Nw5\",\n      \"price\": 48731,\n      \"onsale\": true,\n      \"tax\": 81105,\n      \"weight\": 2004,\n      \"others\": 20465,\n      \"vendor\": \"nozCDMSXRPH Ev\"\n    },\n    {\n      \"product_id\": \"CA6h17ANRwvb\",\n      \"price\": 62102,\n      \"onsale\": true,\n      \"tax\": 96601,\n      \"weight\": 78849,\n      \"others\": 79453,\n      \"vendor\": \" ihVXEJz7E2EFS\"\n    }\n  ],\n  \"platform\": \"GLt9\",\n  \"preference\": {\n    \"key\": \"nmPmsPjg C\",\n    \"value\": true\n  },\n  \"shipping_address\": [\n    {\n      \"name\": \"Loren Bechtelar\",\n      \"street_address\": \"Suite 526 293 Rohan Road, Wunschshire, NE 25532\",\n      \"city\": \"South Norrisland\",\n      \"postcode\": \"56863\"\n    }\n  ],\n  \"shipping_date\": \"2022-11-03\",\n  \"transaction_date\": \"2023-02-01\",\n  \"customer\": {\n    \"username\": \"lance.murphy\",\n    \"name\": \"Zane Brakus DVM\",\n    \"sex\": \"7HcAaPiO\",\n    \"address\": \"594 Loida Haven, Gilland, MA 26071\",\n    \"mail\": \"Un3fhbvK2rEbenIYdnq\",\n    \"birthdate\": \"2023-01-31\"\n  }\n}\n

Looks like we have some data now. But we can do better and add some enhancements to it.

"},{"location":"setup/guide/data-source/open-metadata-source/#custom-metadata","title":"Custom metadata","text":"

We can see from the data generated, that it isn't quite what we want. The metadata is not sufficient for us to produce production-like data yet. Let's try to add some enhancements to it.

Let's make the platform field a choice field that can only be a set of certain values and the nested field customer.sex is also from a predefined set of values.

JavaScala 
var jsonTask = json(\"my_json\", \"/opt/app/data/json\", Map.of(\"saveMode\", \"overwrite\"))\n            .schema(\n                metadata...\n            ))\n            .schema(\n                field().name(\"platform\").oneOf(\"website\", \"mobile\"),\n                field().name(\"customer\").schema(field().name(\"sex\").oneOf(\"M\", \"F\", \"O\"))\n            )\n            .count(count().records(10));\n
val jsonTask = json(\"my_json\", \"/opt/app/data/json\", Map(\"saveMode\" -> \"overwrite\"))\n  .schema(\n    metadata...\n  ))\n  .schema(\n    field.name(\"platform\").oneOf(\"website\", \"mobile\"),\n    field.name(\"customer\").schema(field.name(\"sex\").oneOf(\"M\", \"F\", \"O\"))\n  )\n  .count(count.records(10))\n

Let's test it out by running it again

./run.sh\n#input class MyAdvancedMetadataSourceJavaPlanRun or MyAdvancedMetadataSourcePlanRun\ncat docker/sample/json/part-00000-*\n
{\n  \"comments\": \"vqbPUm\",\n  \"creditcard\": \"6304867705548636\",\n  \"membership\": \"GZ1xOnpZSUOKN\",\n  \"orders\": [\n    {\n      \"product_id\": \"rgOokDAv\",\n      \"price\": 77367,\n      \"onsale\": false,\n      \"tax\": 61742,\n      \"weight\": 87855,\n      \"others\": 26857,\n      \"vendor\": \"04XHR64ImMr9T\"\n    }\n  ],\n  \"platform\": \"mobile\",\n  \"preference\": {\n    \"key\": \"IB5vNdWka\",\n    \"value\": true\n  },\n  \"shipping_address\": [\n    {\n      \"name\": \"Isiah Bins\",\n      \"street_address\": \"36512 Ross Spurs, Hillhaven, IA 18760\",\n      \"city\": \"Averymouth\",\n      \"postcode\": \"75818\"\n    },\n    {\n      \"name\": \"Scott Prohaska\",\n      \"street_address\": \"26573 Haley Ports, Dariusland, MS 90642\",\n      \"city\": \"Ashantimouth\",\n      \"postcode\": \"31792\"\n    },\n    {\n      \"name\": \"Rudolf Stamm\",\n      \"street_address\": \"Suite 878 0516 Danica Path, New Christiaport, ID 10525\",\n      \"city\": \"Doreathaport\",\n      \"postcode\": \"62497\"\n    }\n  ],\n  \"shipping_date\": \"2023-08-24\",\n  \"transaction_date\": \"2023-02-01\",\n  \"customer\": {\n    \"username\": \"jolie.cremin\",\n    \"name\": \"Fay Klein\",\n    \"sex\": \"O\",\n    \"address\": \"Apt. 174 5084 Volkman Creek, Hillborough, PA 61959\",\n    \"mail\": \"BiTmzb7\",\n    \"birthdate\": \"2023-04-07\"\n  }\n}\n

Great! Now we have the ability to get schema information from an external source, add our own metadata and generate data.

"},{"location":"setup/guide/data-source/open-metadata-source/#data-validation","title":"Data validation","text":"

Another aspect of OpenMetadata that can be leveraged is the definition of data quality rules. These rules can be incorporated into your Data Caterer job as well by enabling data validations via enableGenerateValidations in configuration.

JavaScala 
var conf = configuration().enableGeneratePlanAndTasks(true)\n    .enableGenerateValidations(true)\n    .generatedReportsFolderPath(\"/opt/app/data/report\");\n\nexecute(conf, jsonTask);\n
val conf = configuration.enableGeneratePlanAndTasks(true)\n  .enableGenerateValidations(true)\n  .generatedReportsFolderPath(\"/opt/app/data/report\")\n\nexecute(conf, jsonTask)\n

Check out the full example under AdvancedOpenMetadataSourcePlanRun in the example repo.

"},{"location":"setup/guide/data-source/solace/","title":"Solace","text":"

Info

Writing data to Solace is a paid feature. Try the free trial here.

Creating a data generator for Solace. You will build a Docker image that will be able to populate data in Solace for the queues/topics you configure.

"},{"location":"setup/guide/data-source/solace/#requirements","title":"Requirements","text":"
  • 20 minutes
  • Git
  • Gradle
  • Docker
  • Solace
"},{"location":"setup/guide/data-source/solace/#get-started","title":"Get Started","text":"

First, we will clone the data-caterer-example repo which will already have the base project setup required.

git clone git@github.com:pflooky/data-caterer-example.git\n

If you already have a Solace instance running, you can skip to this step.

"},{"location":"setup/guide/data-source/solace/#solace-setup","title":"Solace Setup","text":"

Next, let's make sure you have an instance of Solace up and running in your local environment. This will make it easy for us to iterate and check our changes.

cd docker\ndocker-compose up -d solace\n

Open up localhost:8080 and login with admin:admin and check there is the default VPN like below. Notice there is 2 queues/topics created. If you do not see 2 created, try to run the script found under docker/data/solace/setup_solace.sh and change the host to localhost.

"},{"location":"setup/guide/data-source/solace/#plan-setup","title":"Plan Setup","text":"

Create a new Java or Scala class.

  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedSolaceJavaPlan.java
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedSolacePlan.scala

Make sure your class extends PlanRun.

JavaScala 
import com.github.pflooky.datacaterer.java.api.PlanRun;\n\npublic class MyAdvancedSolaceJavaPlan extends PlanRun {\n}\n
import com.github.pflooky.datacaterer.api.PlanRun\n\nclass MyAdvancedSolacePlan extends PlanRun {\n}\n

This class defines where we need to define all of our configurations for generating data. There are helper variables and methods defined to make it simple and easy to use.

"},{"location":"setup/guide/data-source/solace/#connection-configuration","title":"Connection Configuration","text":"

Within our class, we can start by defining the connection properties to connect to Solace.

JavaScala 
var accountTask = solace(\n    \"my_solace\",                        //name\n    \"smf://host.docker.internal:55554\", //url\n    Map.of()                            //optional additional connection options\n);\n

Additional connection options can be found here.

val accountTask = solace(\n    \"my_solace\",                        //name\n    \"smf://host.docker.internal:55554\", //url\n    Map()                               //optional additional connection options\n)\n

Additional connection options can be found here.

"},{"location":"setup/guide/data-source/solace/#schema","title":"Schema","text":"

Let's create a task for inserting data into the rest_test_queue or rest_test_topic that is already created for us from this step.

Trimming the connection details to work with the docker-compose Solace, we have a base Solace connection to define the JNDI destination we will publish to. Let's define each field along with their corresponding data type. You will notice that the text fields do not have a data type defined. This is because the default data type is StringType.

JavaScala 
{\n    var solaceTask = solace(\"my_solace\", \"smf://host.docker.internal:55554\")\n            .destination(\"/JNDI/Q/rest_test_queue\")\n            .schema(\n                    field().name(\"value\").sql(\"TO_JSON(content)\"),\n                    //field().name(\"partition\").type(IntegerType.instance()),   //can define message JMS priority here\n                    field().name(\"headers\")                                     //set message properties via headers field\n                            .type(HeaderType.getType())\n                            .sql(\n                                    \"ARRAY(\" +\n                                            \"NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8')),\" +\n                                            \"NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))\" +\n                                            \")\"\n                            ),\n                    field().name(\"content\")\n                            .schema(\n                                    field().name(\"account_id\").regex(\"ACC[0-9]{8}\"),\n                                    field().name(\"year\").type(IntegerType.instance()).min(2021).max(2023),\n                                    field().name(\"amount\").type(DoubleType.instance()),\n                                    field().name(\"details\")\n                                            .schema(\n                                                    field().name(\"name\").expression(\"#{Name.name}\"),\n                                                    field().name(\"first_txn_date\").type(DateType.instance()).sql(\"ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)\"),\n                                                    field().name(\"updated_by\")\n                                                            .schema(\n                                                                    field().name(\"user\"),\n                                                                    field().name(\"time\").type(TimestampType.instance())\n                                                            )\n                                            ),\n                                    field().name(\"transactions\").type(ArrayType.instance())\n                                            .schema(\n                                                    field().name(\"txn_date\").type(DateType.instance()).min(Date.valueOf(\"2021-01-01\")).max(\"2021-12-31\"),\n                                                    field().name(\"amount\").type(DoubleType.instance())\n                                            )\n                            )\n            )\n            .count(count().records(10));\n}\n
val solaceTask = solace(\"my_solace\", \"smf://host.docker.internal:55554\")\n  .destination(\"/JNDI/Q/rest_test_queue\")\n  .schema(\n    field.name(\"value\").sql(\"TO_JSON(content)\"),\n    //field.name(\"partition\").`type`(IntegerType),  //can define message JMS priority here\n    field.name(\"headers\")                           //set message properties via headers field\n      .`type`(HeaderType.getType)\n      .sql(\n        \"\"\"ARRAY(\n          |  NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8')),\n          |  NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))\n          |)\"\"\".stripMargin\n      ),\n    field.name(\"content\")\n      .schema(\n        field.name(\"account_id\").regex(\"ACC[0-9]{8}\"),\n        field.name(\"year\").`type`(IntegerType).min(2021).max(2023),\n        field.name(\"amount\").`type`(DoubleType),\n        field.name(\"details\")\n          .schema(\n            field.name(\"name\").expression(\"#{Name.name}\"),\n            field.name(\"first_txn_date\").`type`(DateType).sql(\"ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)\"),\n            field.name(\"updated_by\")\n              .schema(\n                field.name(\"user\"),\n                field.name(\"time\").`type`(TimestampType),\n              ),\n          ),\n        field.name(\"transactions\").`type`(ArrayType)\n          .schema(\n            field.name(\"txn_date\").`type`(DateType).min(Date.valueOf(\"2021-01-01\")).max(\"2021-12-31\"),\n            field.name(\"amount\").`type`(DoubleType),\n          )\n      ),\n  ).count(count.records(10))\n
"},{"location":"setup/guide/data-source/solace/#fields","title":"Fields","text":"

The schema defined for Solace has a format that needs to be followed as noted above. Specifically, the required fields are:

  • value

Whilst, the other fields are optional:

  • partition - refers to JMS priority of the message
  • headers - refers to JMS message properties
"},{"location":"setup/guide/data-source/solace/#headers","title":"headers","text":"

headers follows a particular pattern that where it is of type HeaderType.getType which behind the scenes, translates toarray<struct<key: string,value: binary>>. To be able to generate data for this data type, we need to use an SQL expression like the one below. You will notice that in thevalue part, it refers to content.account_id where content is another field defined at the top level of the schema. This allows you to reference other values that have already been generated.

JavaScala 
field().name(\"headers\")\n        .type(HeaderType.getType())\n        .sql(\n                \"ARRAY(\" +\n                        \"NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8')),\" +\n                        \"NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))\" +\n                        \")\"\n        )\n
field.name(\"headers\")\n  .`type`(HeaderType.getType)\n  .sql(\n    \"\"\"ARRAY(\n      |  NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8')),\n      |  NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))\n      |)\"\"\".stripMargin\n  )\n
"},{"location":"setup/guide/data-source/solace/#transactions","title":"transactions","text":"

transactions is an array that contains an inner structure of txn_date and amount. The size of the array generated can be controlled via arrayMinLength and arrayMaxLength.

JavaScala 
field().name(\"transactions\").type(ArrayType.instance())\n        .schema(\n                field().name(\"txn_date\").type(DateType.instance()).min(Date.valueOf(\"2021-01-01\")).max(\"2021-12-31\"),\n                field().name(\"amount\").type(DoubleType.instance())\n        )\n
field.name(\"transactions\").`type`(ArrayType)\n  .schema(\n    field.name(\"txn_date\").`type`(DateType).min(Date.valueOf(\"2021-01-01\")).max(\"2021-12-31\"),\n    field.name(\"amount\").`type`(DoubleType),\n  )\n
"},{"location":"setup/guide/data-source/solace/#details","title":"details","text":"

details is another example of a nested schema structure where it also has a nested structure itself in updated_by. One thing to note here is the first_txn_date field has a reference to the content.transactions array where it will sort the array by txn_date and get the first element.

JavaScala 
field().name(\"details\")\n        .schema(\n                field().name(\"name\").expression(\"#{Name.name}\"),\n                field().name(\"first_txn_date\").type(DateType.instance()).sql(\"ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)\"),\n                field().name(\"updated_by\")\n                        .schema(\n                                field().name(\"user\"),\n                                field().name(\"time\").type(TimestampType.instance())\n                        )\n        )\n
field.name(\"details\")\n  .schema(\n    field.name(\"name\").expression(\"#{Name.name}\"),\n    field.name(\"first_txn_date\").`type`(DateType).sql(\"ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)\"),\n    field.name(\"updated_by\")\n      .schema(\n        field.name(\"user\"),\n        field.name(\"time\").`type`(TimestampType),\n      ),\n  )\n
"},{"location":"setup/guide/data-source/solace/#additional-configurations","title":"Additional Configurations","text":"

At the end of data generation, a report gets generated that summarises the actions it performed. We can control the output folder of that report via configurations.

JavaScala 
var config = configuration()\n        .generatedReportsFolderPath(\"/opt/app/data/report\");\n
val config = configuration\n  .generatedReportsFolderPath(\"/opt/app/data/report\")\n
"},{"location":"setup/guide/data-source/solace/#execute","title":"Execute","text":"

To tell Data Caterer that we want to run with the configurations along with the kafkaTask, we have to call execute.

"},{"location":"setup/guide/data-source/solace/#run","title":"Run","text":"

Now we can run via the script ./run.sh that is in the top level directory of the data-caterer-example to run the class we just created.

./run.sh\n#input class AdvancedSolaceJavaPlanRun or AdvancedSolacePlanRun\n#after completing, check http://localhost:8080 from browser\n

Your output should look like this.

Unfortunately, there is no easy way to see the message content. You can check the message content from your application or service that consumes these messages.

Also check the HTML report, found at docker/sample/report/index.html, that gets generated to get an overview of what was executed. Or view the sample report found here.

"},{"location":"setup/guide/scenario/auto-generate-connection/","title":"Auto Generate From Data Connection","text":"

Info

Auto data generation from data connection is a paid feature. Try the free trial here.

Creating a data generator based on only a data connection to Postgres.

"},{"location":"setup/guide/scenario/auto-generate-connection/#requirements","title":"Requirements","text":"
  • 5 minutes
  • Git
  • Gradle
  • Docker
"},{"location":"setup/guide/scenario/auto-generate-connection/#get-started","title":"Get Started","text":"

First, we will clone the data-caterer-example repo which will already have the base project setup required.

git clone git@github.com:pflooky/data-caterer-example.git\n
"},{"location":"setup/guide/scenario/auto-generate-connection/#plan-setup","title":"Plan Setup","text":"

Create a new Java or Scala class.

  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedAutomatedJavaPlanRun.java
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedAutomatedPlanRun.scala

Make sure your class extends PlanRun.

JavaScala 
import com.github.pflooky.datacaterer.java.api.PlanRun;\n...\n\npublic class MyAdvancedAutomatedJavaPlanRun extends PlanRun {\n    {\n        var autoRun = configuration()\n                .postgres(\"my_postgres\", \"jdbc:postgresql://host.docker.internal:5432/customer\")  (1)\n                .enableGeneratePlanAndTasks(true)                                                 (2)\n                .generatedPlanAndTaskFolderPath(\"/opt/app/data/generated\")                        (3)\n                .enableUniqueCheck(true)                                                          (4)\n                .generatedReportsFolderPath(\"/opt/app/data/report\");\n\n        execute(autoRun);\n    }\n}\n
import com.github.pflooky.datacaterer.api.PlanRun\n...\n\nclass MyAdvancedAutomatedPlanRun extends PlanRun {\n\n  val autoRun = configuration\n    .postgres(\"my_postgres\", \"jdbc:postgresql://host.docker.internal:5432/customer\")  (1)\n    .enableGeneratePlanAndTasks(true)                                                 (2)\n    .generatedPlanAndTaskFolderPath(\"/opt/app/data/generated\")                        (3)\n    .enableUniqueCheck(true)                                                          (4)\n    .generatedReportsFolderPath(\"/opt/app/data/report\")\n\n  execute(configuration = autoRun)\n}\n

In the above code, we note the following:

  1. Data source configuration to a Postgres data source called my_postgres
  2. We have enabled the flag enableGeneratePlanAndTasks which tells Data Caterer to go to my_postgres and generate data for all the tables found under the database customer (which is defined in the connection string).
  3. The config generatedPlanAndTaskFolderPath defines where the metadata that is gathered from my_postgres should be saved at so that we could re-use it later.
  4. enableUniqueCheck is set to true to ensure that generated data is unique based on primary key or foreign key definitions.

Note

Unique check will only ensure generated data is unique. Any existing data in your data source is not taken into account, so generated data may fail to insert depending on the data source restrictions

"},{"location":"setup/guide/scenario/auto-generate-connection/#postgres-setup","title":"Postgres Setup","text":"

If you don't have your own Postgres up and running, you can set up and run an instance configured in the docker folder via.

cd docker\ndocker-compose up -d postgres\ndocker exec docker-postgresserver-1 psql -Upostgres -d customer -c '\\dt+ account.*'\n

This will create the tables found under docker/data/sql/postgres/customer.sql. You can change this file to contain your own tables. We can see there are 4 tables created for us, accounts, balances, transactions and mapping.

"},{"location":"setup/guide/scenario/auto-generate-connection/#run","title":"Run","text":"

Let's try run.

cd ..\n./run.sh\n#input class MyAdvancedAutomatedJavaPlanRun or MyAdvancedAutomatedPlanRun\n#after completing\ndocker exec docker-postgresserver-1 psql -Upostgres -d customer -c 'select * from account.accounts limit 1;'\n

It should look something like this.

   id   | account_number  | account_status | created_by | created_by_fixed_length | customer_id_int | customer_id_smallint | customer_id_bigint |   customer_id_decimal    | customer_id_real | customer_id_double | open_date  |     open_timestamp      | last_opened_time |                                                           payload_bytes\n--------+-----------------+----------------+------------+-------------------------+-----------------+----------------------+--------------------+--------------------------+------------------+--------------------+------------+-------------------------+------------------+------------------------------------------------------------------------------------------------------------------------------------\n 100414 | 5uROOVOUyQUbubN | h3H            | SfA0eZJcTm | CuRw                    |              13 |                   42 |               6041 | 76987.745612542900000000 |         91866.78 |  66400.37433202339 | 2023-03-05 | 2023-08-14 11:33:11.343 | 23:58:01.736     | \\x604d315d4547616e6a233050415373317274736f5e682d516132524f3d23233c37463463322f342d34376d597e665d6b3d395b4238284028622b7d6d2b4f5042\n(1 row)\n

The data that gets inserted will follow the foreign keys that are defined within Postgres and also ensure the insertion order is correct.

Also check the HTML report that gets generated under docker/sample/report/index.html. You can see a summary of what was generated along with other metadata.

You can now look to play around with other tables or data sources and auto generate for them.

"},{"location":"setup/guide/scenario/auto-generate-connection/#additional-topics","title":"Additional Topics","text":""},{"location":"setup/guide/scenario/auto-generate-connection/#learn-from-existing-data","title":"Learn From Existing Data","text":"

If you have any existing data within your data source, Data Caterer will gather metadata about the existing data to help guide it when generating new data. There are configurations that can help tune the metadata analysis found here.

"},{"location":"setup/guide/scenario/auto-generate-connection/#filter-out-schematables","title":"Filter Out Schema/Tables","text":"

As part of your connection definition, you can define any schemas and/or tables your don't want to generate data for. In the example below, it will not generate any data for any tables under the history and audit schemas. Also, any table with the name balances or transactions in any schema will also not have data generated.

JavaScala 
var autoRun = configuration()\n        .postgres(\n              \"my_postgres\", \n              \"jdbc:postgresql://host.docker.internal:5432/customer\",\n              Map.of(\n                  \"filterOutSchema\", \"history, audit\",\n                  \"filterOutTable\", \"balances, transactions\")\n              )\n        )\n
val autoRun = configuration\n  .postgres(\n    \"my_postgres\",\n    \"jdbc:postgresql://host.docker.internal:5432/customer\",\n    Map(\n      \"filterOutSchema\" -> \"history, audit\",\n      \"filterOutTable\" -> \"balances, transactions\")\n    )\n  )\n
"},{"location":"setup/guide/scenario/auto-generate-connection/#define-record-count","title":"Define record count","text":"

You can control the record count per sub data source via numRecordsPerStep.

JavaScala 
var autoRun = configuration()\n      ...\n      .numRecordsPerStep(100)\n\nexecute(autoRun)\n
val autoRun = configuration\n  ...\n  .numRecordsPerStep(100)\n\nexecute(configuration = autoRun)\n
"},{"location":"setup/guide/scenario/batch-and-event/","title":"Generate Batch and Event Data","text":"

Info

Generating event data is a paid feature. Try the free trial here.

Creating a data generator for Kafka topic with matching records in a CSV file.

"},{"location":"setup/guide/scenario/batch-and-event/#requirements","title":"Requirements","text":"
  • 5 minutes
  • Git
  • Gradle
  • Docker
"},{"location":"setup/guide/scenario/batch-and-event/#get-started","title":"Get Started","text":"

First, we will clone the data-caterer-example repo which will already have the base project setup required.

git clone git@github.com:pflooky/data-caterer-example.git\n
"},{"location":"setup/guide/scenario/batch-and-event/#kafka-setup","title":"Kafka Setup","text":"

If you don't have your own Kafka up and running, you can set up and run an instance configured in the docker folder via.

cd docker\ndocker-compose up -d kafka\ndocker exec docker-kafkaserver-1 kafka-topics --bootstrap-server localhost:9092 --list\n

Let's create a task for inserting data into the account-topic that is already defined underdocker/data/kafka/setup_kafka.sh.

"},{"location":"setup/guide/scenario/batch-and-event/#plan-setup","title":"Plan Setup","text":"

Create a new Java or Scala class.

  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedBatchEventJavaPlanRun.java
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedBatchEventPlanRun.scala

Make sure your class extends PlanRun.

JavaScala 
import com.github.pflooky.datacaterer.java.api.PlanRun;\n...\n\npublic class MyAdvancedBatchEventJavaPlanRun extends PlanRun {\n    {\n        var kafkaTask = new AdvancedKafkaJavaPlanRun().getKafkaTask();\n    }\n}\n
import com.github.pflooky.datacaterer.api.PlanRun\n...\n\nclass MyAdvancedBatchEventPlanRun extends PlanRun {\n  val kafkaTask = new AdvancedKafkaPlanRun().kafkaTask\n}\n

We will borrow the Kafka task that is already defined under the class AdvancedKafkaPlanRun or AdvancedKafkaJavaPlanRun. You can go through the Kafka guide here for more details.

"},{"location":"setup/guide/scenario/batch-and-event/#schema","title":"Schema","text":"

Let us set up the corresponding schema for the CSV file where we want to match the values that are generated for the Kafka messages.

JavaScala 
var kafkaTask = new AdvancedKafkaJavaPlanRun().getKafkaTask();\n\nvar csvTask = csv(\"my_csv\", \"/opt/app/data/csv/account\")\n        .schema(\n                field().name(\"account_number\"),\n                field().name(\"year\"),\n                field().name(\"name\"),\n                field().name(\"payload\")\n        );\n
val kafkaTask = new AdvancedKafkaPlanRun().kafkaTask\n\nval csvTask = csv(\"my_csv\", \"/opt/app/data/csv/account\")\n  .schema(\n    field.name(\"account_number\"),\n    field.name(\"year\"),\n    field.name(\"name\"),\n    field.name(\"payload\")\n)\n

This is a simple schema where we want to use the values and metadata that is already defined in the kafkaTask to determine what the data will look like for the CSV file. Even if we defined some metadata here, it would be overridden when we define our foreign key relationships.

"},{"location":"setup/guide/scenario/batch-and-event/#foreign-keys","title":"Foreign Keys","text":"

From the above CSV schema, we see note the following against the Kafka schema:

  • account_number in CSV needs to match with the account_id in Kafka
    • We see that account_id is referred to in the key column as field.name(\"key\").sql(\"content.account_id\")
  • year needs to match with content.year in Kafka, which is a nested field
    • We can only do foreign key relationships with top level fields, not nested fields. So we define a new column called tmp_year which will not appear in the final output for the Kafka messages but is used as an intermediate step field.name(\"tmp_year\").sql(\"content.year\").omit(true)
  • name needs to match with content.details.name in Kafka, also a nested field
    • Using the same logic as above, we define a temporary column called tmp_name which will take the value of the nested field but will be omitted field.name(\"tmp_name\").sql(\"content.details.name\").omit(true)
  • payload represents the whole JSON message sent to Kafka, which matches to value column

Our foreign keys are therefore defined like below. Order is important when defining the list of columns. The index needs to match with the corresponding column in the other data source.

JavaScala 
var myPlan = plan().addForeignKeyRelationship(\n        kafkaTask, List.of(\"key\", \"tmp_year\", \"tmp_name\", \"value\"),\n        List.of(Map.entry(csvTask, List.of(\"account_number\", \"year\", \"name\", \"payload\")))\n);\n\nvar conf = configuration()\n      .generatedReportsFolderPath(\"/opt/app/data/report\");\n\nexecute(myPlan, conf, kafkaTask, csvTask);\n
val myPlan = plan.addForeignKeyRelationship(\n    kafkaTask, List(\"key\", \"tmp_year\", \"tmp_name\", \"value\"),\n    List(csvTask -> List(\"account_number\", \"year\", \"name\", \"payload\"))\n)\n\nval conf = configuration.generatedReportsFolderPath(\"/opt/app/data/report\")\n\nexecute(myPlan, conf, kafkaTask, csvTask)\n
"},{"location":"setup/guide/scenario/batch-and-event/#run","title":"Run","text":"

Let's try run.

cd ..\n./run.sh\n#input class MyAdvancedBatchEventJavaPlanRun or MyAdvancedBatchEventPlanRun\n#after completing\ndocker exec docker-kafkaserver-1 kafka-console-consumer --bootstrap-server localhost:9092 --topic account-topic --from-beginning\n

It should look something like this.

{\"account_id\":\"ACC03093143\",\"year\":2023,\"amount\":87990.37196728592,\"details\":{\"name\":\"Nadine Heidenreich Jr.\",\"first_txn_date\":\"2021-11-09\",\"updated_by\":{\"user\":\"YfEyJCe8ohrl0j IfyT\",\"time\":\"2022-09-26T20:47:53.404Z\"}},\"transactions\":[{\"txn_date\":\"2021-11-09\",\"amount\":97073.7914706189}]}\n{\"account_id\":\"ACC08764544\",\"year\":2021,\"amount\":28675.58758765888,\"details\":{\"name\":\"Delila Beer\",\"first_txn_date\":\"2021-05-19\",\"updated_by\":{\"user\":\"IzB5ksXu\",\"time\":\"2023-01-26T20:47:26.389Z\"}},\"transactions\":[{\"txn_date\":\"2021-10-01\",\"amount\":80995.23818711648},{\"txn_date\":\"2021-05-19\",\"amount\":92572.40049217848},{\"txn_date\":\"2021-12-11\",\"amount\":99398.79832225188}]}\n{\"account_id\":\"ACC62505420\",\"year\":2023,\"amount\":96125.3125884202,\"details\":{\"name\":\"Shawn Goodwin\",\"updated_by\":{\"user\":\"F3dqIvYp2pFtena4\",\"time\":\"2023-02-11T04:38:29.832Z\"}},\"transactions\":[]}\n

Let's also check if there is a corresponding record in the CSV file.

$ cat docker/sample/csv/account/part-0000* | grep ACC03093143\nACC03093143,2023,Nadine Heidenreich Jr.,\"{\\\"account_id\\\":\\\"ACC03093143\\\",\\\"year\\\":2023,\\\"amount\\\":87990.37196728592,\\\"details\\\":{\\\"name\\\":\\\"Nadine Heidenreich Jr.\\\",\\\"first_txn_date\\\":\\\"2021-11-09\\\",\\\"updated_by\\\":{\\\"user\\\":\\\"YfEyJCe8ohrl0j IfyT\\\",\\\"time\\\":\\\"2022-09-26T20:47:53.404Z\\\"}},\\\"transactions\\\":[{\\\"txn_date\\\":\\\"2021-11-09\\\",\\\"amount\\\":97073.7914706189}]}\"\n

Great! The account, year, name and payload look to all match up.

"},{"location":"setup/guide/scenario/batch-and-event/#additional-topics","title":"Additional Topics","text":""},{"location":"setup/guide/scenario/batch-and-event/#order-of-execution","title":"Order of execution","text":"

You may notice that the events are generated first, then the CSV file. This is because as part of the execute function, we passed in the kafkaTask first, before the csvTask. You can change the order of execution by passing in csvTask before kafkaTask into the execute function.

"},{"location":"setup/guide/scenario/delete-generated-data/","title":"Delete Generated Data","text":"

Info

Delete generated data is a paid feature. Try the free trial here.

Creating a data generator for Postgres and delete the generated data after using it.

"},{"location":"setup/guide/scenario/delete-generated-data/#requirements","title":"Requirements","text":"
  • 5 minutes
  • Git
  • Gradle
  • Docker
"},{"location":"setup/guide/scenario/delete-generated-data/#get-started","title":"Get Started","text":"

First, we will clone the data-caterer-example repo which will already have the base project setup required.

git clone git@github.com:pflooky/data-caterer-example.git\n
"},{"location":"setup/guide/scenario/delete-generated-data/#plan-setup","title":"Plan Setup","text":"

Create a new Java or Scala class.

  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedDeleteJavaPlanRun.java
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedDeletePlanRun.scala

Make sure your class extends PlanRun.

JavaScala 
import com.github.pflooky.datacaterer.java.api.PlanRun;\n...\n\npublic class MyAdvancedDeleteJavaPlanRun extends PlanRun {\n    {\n        var autoRun = configuration()\n                .postgres(\"my_postgres\", \"jdbc:postgresql://host.docker.internal:5432/customer\")  (1)\n                .enableGeneratePlanAndTasks(true)                                                 (2)\n                .enableRecordTracking(true)                                                       (3)\n                .enableDeleteGeneratedRecords(false)                                              (4)\n                .enableUniqueCheck(true)\n                .generatedPlanAndTaskFolderPath(\"/opt/app/data/generated\")                        (5)\n                .recordTrackingFolderPath(\"/opt/app/data/recordTracking\")                         (6)\n                .generatedReportsFolderPath(\"/opt/app/data/report\");\n\n        execute(autoRun);\n   }\n}\n
import com.github.pflooky.datacaterer.api.PlanRun\n...\n\nclass MyAdvancedDeletePlanRun extends PlanRun {\n\n  val autoRun = configuration\n    .postgres(\"my_postgres\", \"jdbc:postgresql://host.docker.internal:5432/customer\")  (1)\n    .enableGeneratePlanAndTasks(true)                                                 (2)\n    .enableRecordTracking(true)                                                       (3)\n    .enableDeleteGeneratedRecords(false)                                              (4)\n    .enableUniqueCheck(true)\n    .generatedPlanAndTaskFolderPath(\"/opt/app/data/generated\")                        (5)\n    .recordTrackingFolderPath(\"/opt/app/data/recordTracking\")                         (6)\n    .generatedReportsFolderPath(\"/opt/app/data/report\")\n\n  execute(configuration = autoRun)\n}\n

In the above code we note the following:

  1. We have defined a Postgres connection called my_postgres
  2. enableGeneratePlanAndTasks is enabled to auto generate data for all tables under customer database
  3. enableRecordTracking is enabled to ensure that all generated records are tracked. This will get used when we want to delete data afterwards
  4. enableDeleteGeneratedRecords is disabled for now. We want to see the generated data first and delete sometime after
  5. generatedPlanAndTaskFolderPath is the folder path where we saved the metadata we have gathered from my_postgres
  6. recordTrackingFolderPath is the folder path where record tracking is maintained. We need to persist this data to ensure it is still available when we want to delete data
"},{"location":"setup/guide/scenario/delete-generated-data/#postgres-setup","title":"Postgres Setup","text":"

If you don't have your own Postgres up and running, you can set up and run an instance configured in the docker folder via.

cd docker\ndocker-compose up -d postgres\ndocker exec docker-postgresserver-1 psql -Upostgres -d customer -c '\\dt+ account.*'\n

This will create the tables found under docker/data/sql/postgres/customer.sql. You can change this file to contain your own tables. We can see there are 4 tables created for us, accounts, balances, transactions and mapping.

"},{"location":"setup/guide/scenario/delete-generated-data/#run","title":"Run","text":"

Let's try run.

cd ..\n./run.sh\n#input class MyAdvancedDeleteJavaPlanRun or MyAdvancedDeletePlanRun\n#after completing\ndocker exec docker-postgresserver-1 psql -Upostgres -d customer -c 'select * from account.accounts limit 1'\n

It should look something like this.

   id   | account_number  | account_status | created_by | created_by_fixed_length | customer_id_int | customer_id_smallint | customer_id_bigint |   customer_id_decimal    | customer_id_real | customer_id_double | open_date  |     open_timestamp      | last_opened_time |                                                           payload_bytes\n--------+-----------------+----------------+------------+-------------------------+-----------------+----------------------+--------------------+--------------------------+------------------+--------------------+------------+-------------------------+------------------+------------------------------------------------------------------------------------------------------------------------------------\n 100414 | 5uROOVOUyQUbubN | h3H            | SfA0eZJcTm | CuRw                    |              13 |                   42 |               6041 | 76987.745612542900000000 |         91866.78 |  66400.37433202339 | 2023-03-05 | 2023-08-14 11:33:11.343 | 23:58:01.736     | \\x604d315d4547616e6a233050415373317274736f5e682d516132524f3d23233c37463463322f342d34376d597e665d6b3d395b4238284028622b7d6d2b4f5042\n(1 row)\n

The data that gets inserted will follow the foreign keys that are defined within Postgres and also ensure the insertion order is correct.

Check the number of records via:

docker exec docker-postgresserver-1 psql -Upostgres -d customer -c 'select count(1) from account.accounts'\n#open report under docker/sample/report/index.html\n
"},{"location":"setup/guide/scenario/delete-generated-data/#delete","title":"Delete","text":"

We are now at a stage where we want to delete the data that was generated. All we need to do is flip two flags.

.enableDeleteGeneratedRecords(true)\n.enableGenerateData(false)  //we need to explicitly disable generating data\n

Enable delete generated records and disable generating data.

Before we run again, let us insert a record manually to see if that data will survive after running the job to delete the generated data.

docker exec docker-postgresserver-1 psql -Upostgres -d customer -c \"insert into account.accounts (account_number) values ('my_account_number')\"\ndocker exec docker-postgresserver-1 psql -Upostgres -d customer -c \"select count(1) from account.accounts\"\n

We now should have 1001 records in our account.accounts table. Let's delete the generated data now.

./run.sh\n#input class MyAdvancedDeleteJavaPlanRun or MyAdvancedDeletePlanRun\n#after completing\ndocker exec docker-postgresserver-1 psql -Upostgres -d customer -c 'select * from account.accounts limit 1'\ndocker exec docker-postgresserver-1 psql -Upostgres -d customer -c 'select count(1) from account.accounts'\n

You should see that only 1 record is left, the one that we manually inserted. Great, now we can generate data reliably and also be able to clean it up.

"},{"location":"setup/guide/scenario/delete-generated-data/#additional-topics","title":"Additional Topics","text":""},{"location":"setup/guide/scenario/delete-generated-data/#one-class-for-generating-another-for-deleting","title":"One class for generating, another for deleting?","text":"

Yes, this is possible. There are two requirements: - the connection names used need to be the same across both classes - recordTrackingFolderPath needs to be set to the same value

"},{"location":"setup/guide/scenario/delete-generated-data/#define-record-count","title":"Define record count","text":"

You can control the record count per sub data source via numRecordsPerStep.

JavaScala 
var autoRun = configuration()\n      ...\n      .numRecordsPerStep(100)\n\nexecute(autoRun)\n
val autoRun = configuration\n  ...\n  .numRecordsPerStep(100)\n\nexecute(configuration = autoRun)\n
"},{"location":"setup/guide/scenario/first-data-generation/","title":"First Data Generation","text":"

Creating a data generator for a CSV file.

"},{"location":"setup/guide/scenario/first-data-generation/#requirements","title":"Requirements","text":"
  • 20 minutes
  • Git
  • Gradle
  • Docker
"},{"location":"setup/guide/scenario/first-data-generation/#get-started","title":"Get Started","text":"

First, we will clone the data-caterer-example repo which will already have the base project setup required.

git clone git@github.com:pflooky/data-caterer-example.git\n
"},{"location":"setup/guide/scenario/first-data-generation/#plan-setup","title":"Plan Setup","text":"

Create a new Java or Scala class.

  • Java: src/main/java/com/github/pflooky/plan/MyCsvPlan.java
  • Scala: src/main/scala/com/github/pflooky/plan/MyCsvPlan.scala

Make sure your class extends PlanRun.

JavaScala 
import com.github.pflooky.datacaterer.java.api.PlanRun;\n\npublic class MyCsvJavaPlan extends PlanRun {\n}\n
import com.github.pflooky.datacaterer.api.PlanRun\n\nclass MyCsvPlan extends PlanRun {\n}\n

This class defines where we need to define all of our configurations for generating data. There are helper variables and methods defined to make it simple and easy to use.

"},{"location":"setup/guide/scenario/first-data-generation/#connection-configuration","title":"Connection Configuration","text":"

When dealing with CSV files, we need to define a path for our generated CSV files to be saved at, along with any other high level configurations.

JavaScala 
csv(\n  \"customer_accounts\",              //name\n  \"/opt/app/data/customer/account\", //path\n  Map.of(\"header\", \"true\")          //optional additional options\n)\n

Other additional options for CSV can be found here

csv(\n  \"customer_accounts\",              //name\n  \"/opt/app/data/customer/account\", //path\n  Map(\"header\" -> \"true\")           //optional additional options\n)\n

Other additional options for CSV can be found here

"},{"location":"setup/guide/scenario/first-data-generation/#schema","title":"Schema","text":"

Our CSV file that we generate should adhere to a defined schema where we can also define data types.

Let's define each field along with their corresponding data type. You will notice that the string fields do not have a data type defined. This is because the default data type is StringType.

JavaScala 
var accountTask = csv(\"customer_accounts\", \"/opt/app/data/customer/account\", Map.of(\"header\", \"true\"))\n        .schema(\n                field().name(\"account_id\"),\n                field().name(\"balance\").type(DoubleType.instance()),\n                field().name(\"created_by\"),\n                field().name(\"name\"),\n                field().name(\"open_time\").type(TimestampType.instance()),\n                field().name(\"status\")\n        );\n
val accountTask = csv(\"customer_accounts\", \"/opt/app/data/customer/account\", Map(\"header\" -> \"true\"))\n  .schema(\n    field.name(\"account_id\"),\n    field.name(\"balance\").`type`(DoubleType),\n    field.name(\"created_by\"),\n    field.name(\"name\"),\n    field.name(\"open_time\").`type`(TimestampType),\n    field.name(\"status\")\n  )\n
"},{"location":"setup/guide/scenario/first-data-generation/#field-metadata","title":"Field Metadata","text":"

We could stop here and generate random data for the accounts table. But wouldn't it be more useful if we produced data that is closer to the structure of the data that would come in production? We can do this by defining various metadata attributes that add guidelines that the data generator will understand when generating data.

"},{"location":"setup/guide/scenario/first-data-generation/#account_id","title":"account_id","text":"
  • account_id follows a particular pattern that where it starts with ACC and has 8 digits after it. This can be defined via a regex like below. Alongside, we also mention that values are unique ensure that unique values are generated.
JavaScala 
field().name(\"account_id\").regex(\"ACC[0-9]{8}\").unique(true),\n
field.name(\"account_id\").regex(\"ACC[0-9]{8}\").unique(true),\n
"},{"location":"setup/guide/scenario/first-data-generation/#balance","title":"balance","text":"
  • balance let's make the numbers not too large, so we can define a min and max for the generated numbers to be between 1 and 1000.
JavaScala 
field().name(\"balance\").type(DoubleType.instance()).min(1).max(1000),\n
field.name(\"balance\").`type`(DoubleType).min(1).max(1000),\n
"},{"location":"setup/guide/scenario/first-data-generation/#name","title":"name","text":"
  • name is a string that also follows a certain pattern, so we could also define a regex but here we will choose to leverage the DataFaker library and create an expression to generate real looking name. All possible faker expressions can be found here
JavaScala 
field().name(\"name\").expression(\"#{Name.name}\"),\n
field.name(\"name\").expression(\"#{Name.name}\"),\n
"},{"location":"setup/guide/scenario/first-data-generation/#open_time","title":"open_time","text":"
  • open_time is a timestamp that we want to have a value greater than a specific date. We can define a min date by using java.sql.Date like below.
JavaScala 
field().name(\"open_time\").type(TimestampType.instance()).min(java.sql.Date.valueOf(\"2022-01-01\")),\n
field.name(\"open_time\").`type`(TimestampType).min(java.sql.Date.valueOf(\"2022-01-01\")),\n
"},{"location":"setup/guide/scenario/first-data-generation/#status","title":"status","text":"
  • status is a field that can only obtain one of four values, open, closed, suspended or pending.
JavaScala 
field().name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n
field.name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n
"},{"location":"setup/guide/scenario/first-data-generation/#created_by","title":"created_by","text":"
  • created_by is a field that is based on the status field where it follows the logic: if status is open or closed, then it is created_by eod else created_by event. This can be achieved by defining a SQL expression like below.
JavaScala 
field().name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n
field.name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n

Putting it all the fields together, our class should now look like this.

JavaScala 
var accountTask = csv(\"customer_accounts\", \"/opt/app/data/customer/account\", Map.of(\"header\", \"true\"))\n        .schema(\n                field().name(\"account_id\").regex(\"ACC[0-9]{8}\").unique(true),\n                field().name(\"balance\").type(DoubleType.instance()).min(1).max(1000),\n                field().name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n                field().name(\"name\").expression(\"#{Name.name}\"),\n                field().name(\"open_time\").type(TimestampType.instance()).min(java.sql.Date.valueOf(\"2022-01-01\")),\n                field().name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n        );\n
val accountTask = csv(\"customer_accounts\", \"/opt/app/data/customer/account\", Map(\"header\" -> \"true\"))\n  .schema(\n    field.name(\"account_id\").regex(\"ACC[0-9]{8}\").unique(true),\n    field.name(\"balance\").`type`(DoubleType).min(1).max(1000),\n    field.name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n    field.name(\"name\").expression(\"#{Name.name}\"),\n    field.name(\"open_time\").`type`(TimestampType).min(java.sql.Date.valueOf(\"2022-01-01\")),\n    field.name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n  )\n
"},{"location":"setup/guide/scenario/first-data-generation/#record-count","title":"Record Count","text":"

We only want to generate 100 records, so that we can see what the output looks like. This is controlled at the accountTask level like below. If you want to generate more records, set it to the value you want.

JavaScala 
var accountTask = csv(\"customer_accounts\", \"/opt/app/data/customer/account\", Map.of(\"header\", \"true\"))\n        .schema(\n                ...\n        )\n        .count(count().records(100));\n
val accountTask = csv(\"customer_accounts\", \"/opt/app/data/customer/account\", Map(\"header\" -> \"true\"))\n  .schema(\n    ...\n  )\n  .count(count.records(100))\n
"},{"location":"setup/guide/scenario/first-data-generation/#additional-configurations","title":"Additional Configurations","text":"

At the end of data generation, a report gets generated that summarises the actions it performed. We can control the output folder of that report via configurations. We will also enable the unique check to ensure any unique fields will have unique values generated.

JavaScala 
var config = configuration()\n        .generatedReportsFolderPath(\"/opt/app/data/report\")\n        .enableUniqueCheck(true);\n
val config = configuration\n  .generatedReportsFolderPath(\"/opt/app/data/report\")\n  .enableUniqueCheck(true)\n
"},{"location":"setup/guide/scenario/first-data-generation/#execute","title":"Execute","text":"

To tell Data Caterer that we want to run with the configurations along with the accountTask, we have to call execute . So our full plan run will look like this.

JavaScala 
public class MyCsvJavaPlan extends PlanRun {\n    {\n        var accountTask = csv(\"customer_accounts\", \"/opt/app/data/customer/account\", Map.of(\"header\", \"true\"))\n                .schema(\n                        field().name(\"account_id\").regex(\"ACC[0-9]{8}\").unique(true),\n                        field().name(\"balance\").type(DoubleType.instance()).min(1).max(1000),\n                        field().name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n                        field().name(\"name\").expression(\"#{Name.name}\"),\n                        field().name(\"open_time\").type(TimestampType.instance()).min(java.sql.Date.valueOf(\"2022-01-01\")),\n                        field().name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n                );\n\n        var config = configuration()\n                .generatedReportsFolderPath(\"/opt/app/data/report\")\n                .enableUniqueCheck(true);\n\n        execute(config, accountTask);\n    }\n}\n
class MyCsvPlan extends PlanRun {\n\n  val accountTask = csv(\"customer_accounts\", \"/opt/app/data/customer/account\", Map(\"header\" -> \"true\"))\n    .schema(\n      field.name(\"account_id\").regex(\"ACC[0-9]{8}\").unique(true),\n      field.name(\"balance\").`type`(DoubleType).min(1).max(1000),\n      field.name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n      field.name(\"name\").expression(\"#{Name.name}\"),\n      field.name(\"open_time\").`type`(TimestampType).min(java.sql.Date.valueOf(\"2022-01-01\")),\n      field.name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n    )\n    val config = configuration\n      .generatedReportsFolderPath(\"/opt/app/data/report\")\n      .enableUniqueCheck(true)\n\n    execute(config, accountTask)\n}\n
"},{"location":"setup/guide/scenario/first-data-generation/#run","title":"Run","text":"

Now we can run via the script ./run.sh that is in the top level directory of the data-caterer-example to run the class we just created.

./run.sh\n#input class MyCsvJavaPlan or MyCsvPlan\n#after completing\nhead docker/sample/customer/account/part-00000*\n

Your output should look like this.

account_id,balance,created_by,name,open_time,status\nACC06192462,853.9843359645766,eod,Hoyt Kertzmann MD,2023-07-22T11:17:01.713Z,closed\nACC15350419,632.5969895326234,eod,Dr. Claude White,2022-12-13T21:57:56.840Z,open\nACC25134369,592.0958847218986,eod,Fabian Rolfson,2023-04-26T04:54:41.068Z,open\nACC48021786,656.6413439322964,eod,Dewayne Stroman,2023-05-17T06:31:27.603Z,open\nACC26705211,447.2850352884595,event,Garrett Funk,2023-07-14T03:50:22.746Z,pending\nACC03150585,750.4568929015996,event,Natisha Reichel,2023-04-11T11:13:10.080Z,suspended\nACC29834210,686.4257811608622,event,Gisele Ondricka,2022-11-15T22:09:41.172Z,suspended\nACC39373863,583.5110618128994,event,Thaddeus Ortiz,2022-09-30T06:33:57.193Z,suspended\nACC39405798,989.2623959059525,eod,Shelby Reinger,2022-10-23T17:29:17.564Z,open\n

Also check the HTML report, found at docker/sample/report/index.html, that gets generated to get an overview of what was executed.

"},{"location":"setup/guide/scenario/first-data-generation/#join-with-another-csv","title":"Join With Another CSV","text":"

Now that we have generated some accounts, let's also try to generate a set of transactions for those accounts in CSV format as well. The transactions could be in any other format, but to keep this simple, we will continue using CSV.

We can define our schema the same way along with any additional metadata.

JavaScala 
var transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map.of(\"header\", \"true\"))\n        .schema(\n                field().name(\"account_id\"),\n                field().name(\"name\"),\n                field().name(\"amount\").type(DoubleType.instance()).min(1).max(100),\n                field().name(\"time\").type(TimestampType.instance()).min(java.sql.Date.valueOf(\"2022-01-01\")),\n                field().name(\"date\").type(DateType.instance()).sql(\"DATE(time)\")\n        );\n
val transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map(\"header\" -> \"true\"))\n  .schema(\n    field.name(\"account_id\"),\n    field.name(\"full_name\"),\n    field.name(\"amount\").`type`(DoubleType).min(1).max(100),\n    field.name(\"time\").`type`(TimestampType).min(java.sql.Date.valueOf(\"2022-01-01\")),\n    field.name(\"date\").`type`(DateType).sql(\"DATE(time)\")\n  )\n
"},{"location":"setup/guide/scenario/first-data-generation/#records-per-column","title":"Records Per Column","text":"

Usually, for a given account_id, full_name, there should be multiple records for it as we want to simulate a customer having multiple transactions. We can achieve this through defining the number of records to generate in the count function.

JavaScala 
var transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map.of(\"header\", \"true\"))\n        .schema(\n                ...\n        )\n        .count(count().recordsPerColumn(5, \"account_id\", \"full_name\"));\n
val transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map(\"header\" -> \"true\"))\n  .schema(\n    ...\n  )\n  .count(count.recordsPerColumn(5, \"account_id\", \"full_name\"))\n
"},{"location":"setup/guide/scenario/first-data-generation/#random-records-per-column","title":"Random Records Per Column","text":"

Above, you will notice that we are generating 5 records per account_id, full_name. This is okay but still not quite reflective of the real world. Sometimes, people have accounts with no transactions in them, or they could have many. We can accommodate for this via defining a random number of records per column.

JavaScala 
var transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map.of(\"header\", \"true\"))\n        .schema(\n                ...\n        )\n        .count(count().recordsPerColumnGenerator(generator().min(0).max(5), \"account_id\", \"full_name\"));\n
val transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map(\"header\" -> \"true\"))\n  .schema(\n    ...\n  )\n  .count(count.recordsPerColumnGenerator(generator.min(0).max(5), \"account_id\", \"full_name\"))\n

Here we set the minimum number of records per column to be 0 and the maximum to 5.

"},{"location":"setup/guide/scenario/first-data-generation/#foreign-key","title":"Foreign Key","text":"

In this scenario, we want to match the account_id in account to match the same column values in transaction. We also want to match name in account to full_name in transaction. This can be done via plan configuration like below.

JavaScala 
var myPlan = plan().addForeignKeyRelationship(\n        accountTask, List.of(\"account_id\", \"name\"), //the task and columns we want linked\n        List.of(Map.entry(transactionTask, List.of(\"account_id\", \"full_name\"))) //list of other tasks and their respective column names we want matched\n);\n
val myPlan = plan.addForeignKeyRelationship(\n  accountTask, List(\"account_id\", \"name\"),  //the task and columns we want linked\n  List(transactionTask -> List(\"account_id\", \"full_name\"))  //list of other tasks and their respective column names we want matched\n)\n

Now, stitching it all together for the execute function, our final plan should look like this.

JavaScala 
public class MyCsvJavaPlan extends PlanRun {\n    {\n        var accountTask = csv(\"customer_accounts\", \"/opt/app/data/customer/account\", Map.of(\"header\", \"true\"))\n                .schema(\n                        field().name(\"account_id\").regex(\"ACC[0-9]{8}\").unique(true),\n                        field().name(\"balance\").type(DoubleType.instance()).min(1).max(1000),\n                        field().name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n                        field().name(\"name\").expression(\"#{Name.name}\"),\n                        field().name(\"open_time\").type(TimestampType.instance()).min(java.sql.Date.valueOf(\"2022-01-01\")),\n                        field().name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n                )\n                .count(count().records(100));\n\n        var transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map.of(\"header\", \"true\"))\n                .schema(\n                        field().name(\"account_id\"),\n                        field().name(\"name\"),\n                        field().name(\"amount\").type(DoubleType.instance()).min(1).max(100),\n                        field().name(\"time\").type(TimestampType.instance()).min(java.sql.Date.valueOf(\"2022-01-01\")),\n                        field().name(\"date\").type(DateType.instance()).sql(\"DATE(time)\")\n                )\n                .count(count().recordsPerColumnGenerator(generator().min(0).max(5), \"account_id\", \"full_name\"));\n\n        var config = configuration()\n                .generatedReportsFolderPath(\"/opt/app/data/report\")\n                .enableUniqueCheck(true);\n\n        var myPlan = plan().addForeignKeyRelationship(\n                accountTask, List.of(\"account_id\", \"name\"),\n                List.of(Map.entry(transactionTask, List.of(\"account_id\", \"full_name\")))\n        );\n\n        execute(myPlan, config, accountTask, transactionTask);\n    }\n}\n
class MyCsvPlan extends PlanRun {\n\n  val accountTask = csv(\"customer_accounts\", \"/opt/app/data/customer/account\", Map(\"header\" -> \"true\"))\n    .schema(\n      field.name(\"account_id\").regex(\"ACC[0-9]{8}\").unique(true),\n      field.name(\"balance\").`type`(DoubleType).min(1).max(1000),\n      field.name(\"created_by\").sql(\"CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END\"),\n      field.name(\"name\").expression(\"#{Name.name}\"),\n      field.name(\"open_time\").`type`(TimestampType).min(java.sql.Date.valueOf(\"2022-01-01\")),\n      field.name(\"status\").oneOf(\"open\", \"closed\", \"suspended\", \"pending\")\n    )\n    .count(count.records(100))\n\n  val transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map(\"header\" -> \"true\"))\n    .schema(\n      field.name(\"account_id\"),\n      field.name(\"name\"),\n      field.name(\"amount\").`type`(DoubleType).min(1).max(100),\n      field.name(\"time\").`type`(TimestampType).min(java.sql.Date.valueOf(\"2022-01-01\")),\n      field.name(\"date\").`type`(DateType).sql(\"DATE(time)\")\n    )\n    .count(count.recordsPerColumnGenerator(generator.min(0).max(5), \"account_id\", \"full_name\"))\n\n  val config = configuration\n    .generatedReportsFolderPath(\"/opt/app/data/report\")\n    .enableUniqueCheck(true)\n\n  val myPlan = plan.addForeignKeyRelationship(\n    accountTask, List(\"account_id\", \"name\"),\n    List(transactionTask -> List(\"account_id\", \"full_name\"))\n  )\n\n  execute(myPlan, config, accountTask, transactionTask)\n}\n

Let's try run again.

#clean up old data\nrm -rf docker/sample/customer/account\n./run.sh\n#input class MyCsvJavaPlan or MyCsvPlan\n#after completing, let's pick an account and check the transactions for that account\naccount=$(tail -1 docker/sample/customer/account/part-00000* | awk -F \",\" '{print $1 \",\" $4}')\necho $account\ncat docker/sample/customer/transaction/part-00000* | grep $account\n

It should look something like this.

ACC29117767,Willodean Sauer\nACC29117767,Willodean Sauer,84.99145871948083,2023-05-14T09:55:51.439Z,2023-05-14\nACC29117767,Willodean Sauer,58.89345733567232,2022-11-22T07:38:20.143Z,2022-11-22\n

Congratulations! You have now made a data generator that has simulated a real world data scenario. You can check the DocumentationJavaPlanRun.java or DocumentationPlanRun.scala files as well to check that your plan is the same.

We can now look to consume this CSV data from a job or service. Usually, once we have consumed the data, we would also want to check and validate that our consumer has correctly ingested the data.

"},{"location":"setup/guide/scenario/first-data-generation/#validate","title":"Validate","text":"

In this scenario, our consumer will read in the CSV file, do some transformations, and then save the data to Postgres. Let's try to configure data validations for the data that gets pushed into Postgres.

"},{"location":"setup/guide/scenario/first-data-generation/#postgres-setup","title":"Postgres setup","text":"

First, we define our connection properties for Postgres. You can check out the full options available here.

JavaScala 
var postgresValidateTask = postgres(\n    \"my_postgres\",                                          //connection name\n    \"jdbc:postgresql://host.docker.internal:5432/customer\", //url\n    \"postgres\",                                             //username\n    \"password\"                                              //password\n).table(\"account\", \"transactions\");\n
val postgresValidateTask = postgres(\n  \"my_postgres\",                                          //connection name\n  \"jdbc:postgresql://host.docker.internal:5432/customer\", //url\n  \"postgres\",                                             //username\n  \"password\"                                              //password\n).table(\"account\", \"transactions\")\n

We can connect and access the data inside the table account.transactions. Now to define our data validations.

"},{"location":"setup/guide/scenario/first-data-generation/#validations","title":"Validations","text":"

For full information about validation options and configurations, check here. Below, we have an example that should give you a good understanding of what validations are possible.

JavaScala 
var postgresValidateTask = postgres(...)\n        .table(\"account\", \"transactions\")\n        .validations(\n                validation().col(\"account_id\").isNotNull(),\n                validation().col(\"name\").matches(\"[A-Z][a-z]+ [A-Z][a-z]+\").errorThreshold(0.2).description(\"Some names have different formats\"),\n                validation().col(\"balance\").greaterThanOrEqual(0).errorThreshold(10).description(\"Account can have negative balance if overdraft\"),\n                validation().expr(\"CASE WHEN status == 'closed' THEN isNotNull(close_date) ELSE isNull(close_date) END\"),\n                validation().unique(\"account_id\", \"name\"),\n                validation().groupBy(\"account_id\", \"name\").max(\"login_retry\").lessThan(10)\n        );\n
val postgresValidateTask = postgres(...)\n  .table(\"account\", \"transactions\")\n  .validations(\n    validation.col(\"account_id\").isNotNull,\n    validation.col(\"name\").matches(\"[A-Z][a-z]+ [A-Z][a-z]+\").errorThreshold(0.2).description(\"Some names have different formats\"),\n    validation.col(\"balance\").greaterThanOrEqual(0).errorThreshold(10).description(\"Account can have negative balance if overdraft\"),\n    validation.expr(\"CASE WHEN status == 'closed' THEN isNotNull(close_date) ELSE isNull(close_date) END\"),\n    validation.unique(\"account_id\", \"name\"),\n    validation.groupBy(\"account_id\", \"name\").max(\"login_retry\").lessThan(10)\n  )\n
"},{"location":"setup/guide/scenario/first-data-generation/#name_1","title":"name","text":"

For all values in the name column, we check if they match the regex [A-Z][a-z]+ [A-Z][a-z]+. As we know in the real world, names do not always follow the same pattern, so we allow for an errorThreshold before marking the validation as failed. Here, we define the errorThreshold to be 0.2, which means, if the error percentage is greater than 20%, then fail the validation. We also append on a helpful description so other developers/users can understand the context of the validation.

"},{"location":"setup/guide/scenario/first-data-generation/#balance_1","title":"balance","text":"

We check that all balance values are greater than or equal to 0. This time, we have a slightly different errorThreshold as it is set to 10, which means, if the number of errors is greater than 10, then fail the validation.

"},{"location":"setup/guide/scenario/first-data-generation/#expr","title":"expr","text":"

Sometimes, we may need to include the values of multiple columns to validate a certain condition. This is where we can use expr to define a SQL expression that returns a boolean. In this scenario, we are checking if the status column has value closed, then the close_date should be not null, otherwise, close_date is null.

"},{"location":"setup/guide/scenario/first-data-generation/#unique","title":"unique","text":"

We check whether the combination of account_id and name are unique within the dataset. You can define one or more columns for unique validations.

"},{"location":"setup/guide/scenario/first-data-generation/#groupby","title":"groupBy","text":"

There may be some business rule that states the number of login_retry should be less than 10 for each account. We can check this via a group by validation where we group by the account_id, name, take the maximum value for login_retry per account_id,name combination, then check if it is less than 10.

You can now look to play around with other configurations or data sources to meet your needs. Also, make sure to explore the docs further as it can guide you on what can be configured.

"},{"location":"setup/guide/scenario/records-per-column/","title":"Multiple Records Per Column","text":"

Creating a data generator for a CSV file where there are multiple records per column values.

"},{"location":"setup/guide/scenario/records-per-column/#requirements","title":"Requirements","text":"
  • 5 minutes
  • Git
  • Gradle
  • Docker
"},{"location":"setup/guide/scenario/records-per-column/#get-started","title":"Get Started","text":"

First, we will clone the data-caterer-example repo which will already have the base project setup required.

git clone git@github.com:pflooky/data-caterer-example.git\n
"},{"location":"setup/guide/scenario/records-per-column/#plan-setup","title":"Plan Setup","text":"

Create a new Java or Scala class.

  • Java: src/main/java/com/github/pflooky/plan/MyMultipleRecordsPerColJavaPlan.java
  • Scala: src/main/scala/com/github/pflooky/plan/MyMultipleRecordsPerColPlan.scala

Make sure your class extends PlanRun.

JavaScala 
import com.github.pflooky.datacaterer.java.api.PlanRun;\n...\n\npublic class MyMultipleRecordsPerColJavaPlan extends PlanRun {\n    {\n        var transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map.of(\"header\", \"true\"))\n                .schema(\n                        field().name(\"account_id\"),\n                        field().name(\"full_name\"),\n                        field().name(\"amount\").type(DoubleType.instance()).min(1).max(100),\n                        field().name(\"time\").type(TimestampType.instance()).min(java.sql.Date.valueOf(\"2022-01-01\")),\n                        field().name(\"date\").type(DateType.instance()).sql(\"DATE(time)\")\n                )\n\n        var config = configuration()\n                .generatedReportsFolderPath(\"/opt/app/data/report\")\n                .enableUniqueCheck(true);\n\n        execute(config, transactionTask);\n    }\n}\n
import com.github.pflooky.datacaterer.api.PlanRun\n...\n\nclass MyMultipleRecordsPerColPlan extends PlanRun {\n\n  val transactionTask: ConnectionTaskBuilder[FileBuilder] = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map(\"header\" -> \"true\"))\n    .schema(\n      field.name(\"account_id\").regex(\"ACC[0-9]{8}\"), \n      field.name(\"full_name\").expression(\"#{Name.name}\"), \n      field.name(\"amount\").`type`(DoubleType.instance).min(1).max(100),\n      field.name(\"time\").`type`(TimestampType.instance).min(java.sql.Date.valueOf(\"2022-01-01\")), \n      field.name(\"date\").`type`(DateType.instance).sql(\"DATE(time)\")\n    )\n\n  val config = configuration\n    .generatedReportsFolderPath(\"/opt/app/data/report\")\n\n  execute(config, transactionTask)\n}\n
"},{"location":"setup/guide/scenario/records-per-column/#record-count","title":"Record Count","text":"

By default, tasks will generate 1000 records. You can alter this value via the count configuration which can be applied to individual tasks. For example, in Scala, csv(...).count(count.records(100)) to generate only 100 records.

"},{"location":"setup/guide/scenario/records-per-column/#records-per-column","title":"Records Per Column","text":"

In this scenario, for a given account_id, full_name, there should be multiple records for it as we want to simulate a customer having multiple transactions. We can achieve this through defining the number of records to generate in the count function.

JavaScala 
var transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map.of(\"header\", \"true\"))\n        .schema(\n                ...\n        )\n        .count(count().recordsPerColumn(5, \"account_id\", \"full_name\"));\n
val transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map(\"header\" -> \"true\"))\n  .schema(\n    ...\n  )\n  .count(count.recordsPerColumn(5, \"account_id\", \"full_name\"))\n

This will generate 1000 * 5 = 5000 records as the default number of records is set (1000) and per account_id, full_name from the initial 1000 records, 5 records will be generated.

"},{"location":"setup/guide/scenario/records-per-column/#random-records-per-column","title":"Random Records Per Column","text":"

Generating 5 records per column is okay but still not quite reflective of the real world. Sometimes, people have accounts with no transactions in them, or they could have many. We can accommodate for this via defining a random number of records per column.

JavaScala 
var transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map.of(\"header\", \"true\"))\n        .schema(\n                ...\n        )\n        .count(count().recordsPerColumnGenerator(generator().min(0).max(5), \"account_id\", \"full_name\"));\n
val transactionTask = csv(\"customer_transactions\", \"/opt/app/data/customer/transaction\", Map(\"header\" -> \"true\"))\n  .schema(\n    ...\n  )\n  .count(count.recordsPerColumnGenerator(generator.min(0).max(5), \"account_id\", \"full_name\"))\n

Here we set the minimum number of records per column to be 0 and the maximum to 5. This will follow a uniform distribution so the average number of records per account is 2.5. We could also define other metadata, just like we did with fields, when defining the generator. For example, we could set standardDeviation and mean for the number of records generated per column to follow a normal distribution.

"},{"location":"setup/guide/scenario/records-per-column/#run","title":"Run","text":"

Let's try run.

#clean up old data\nrm -rf docker/sample/customer/account\n./run.sh\n#input class MyMultipleRecordsPerColJavaPlan or MyMultipleRecordsPerColPlan\n#after completing\nhead docker/sample/customer/transaction/part-00000*\n

It should look something like this.

ACC29117767,Willodean Sauer\nACC29117767,Willodean Sauer,84.99145871948083,2023-05-14T09:55:51.439Z,2023-05-14\nACC29117767,Willodean Sauer,58.89345733567232,2022-11-22T07:38:20.143Z,2022-11-22\n

You can now look to play around with other count configurations found here.

"},{"location":"setup/validation/basic-validation/","title":"Basic Validations","text":"

Run validations on a column to ensure the values adhere to your requirement. Can be set to complex validation logic via SQL expression as well if needed (see here).

"},{"location":"setup/validation/basic-validation/#equal","title":"Equal","text":"

Ensure all data in column is equal to certain value. Value can be of any data type.

JavaScalaYAML 
validation().col(\"year\").isEqual(2021)\n
validation.col(\"year\").isEqual(2021)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"year == 2021\"\n
"},{"location":"setup/validation/basic-validation/#not-equal","title":"Not Equal","text":"

Ensure all data in column is not equal to certain value. Value can be of any data type.

JavaScalaYAML 
validation().col(\"year\").isNotEqual(2021)\n
validation.col(\"year\").isNotEqual(2021)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"year != 2021\"\n
"},{"location":"setup/validation/basic-validation/#null","title":"Null","text":"

Ensure all data in column is null.

JavaScalaYAML 
validation().col(\"year\").isNull()\n
validation.col(\"year\").isNull\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"ISNULL(year)\"\n
"},{"location":"setup/validation/basic-validation/#not-null","title":"Not Null","text":"

Ensure all data in column is not null.

JavaScalaYAML 
validation().col(\"year\").isNotNull()\n
validation.col(\"year\").isNotNull\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"ISNOTNULL(year)\"\n
"},{"location":"setup/validation/basic-validation/#contains","title":"Contains","text":"

Ensure all data in column is contains certain string. Column has to have type string.

JavaScalaYAML 
validation().col(\"name\").contains(\"peter\")\n
validation.col(\"name\").contains(\"peter\")\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"CONTAINS(name, 'peter')\"\n
"},{"location":"setup/validation/basic-validation/#not-contains","title":"Not Contains","text":"

Ensure all data in column does not contain certain string. Column has to have type string.

JavaScalaYAML 
validation().col(\"name\").notContains(\"peter\")\n
validation.col(\"name\").notContains(\"peter\")\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"!CONTAINS(name, 'peter')\"\n
"},{"location":"setup/validation/basic-validation/#unqiue","title":"Unqiue","text":"

Ensure all data in column is unique.

JavaScalaYAML 
validation().unique(\"account_id\", \"name\")\n
validation.unique(\"account_id\", \"name\")\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - unique: [\"account_id\", \"name\"]\n
"},{"location":"setup/validation/basic-validation/#less-than","title":"Less Than","text":"

Ensure all data in column is less than certain value.

JavaScalaYAML 
validation().col(\"amount\").lessThan(100)\n
validation.col(\"amount\").lessThan(100)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"amount < 100\"\n
"},{"location":"setup/validation/basic-validation/#less-than-or-equal","title":"Less Than Or Equal","text":"

Ensure all data in column is less than or equal to certain value.

JavaScalaYAML 
validation().col(\"amount\").lessThanOrEqual(100)\n
validation.col(\"amount\").lessThanOrEqual(100)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"amount <= 100\"\n
"},{"location":"setup/validation/basic-validation/#greater-than","title":"Greater Than","text":"

Ensure all data in column is greater than certain value.

JavaScalaYAML 
validation().col(\"amount\").greaterThan(100)\n
validation.col(\"amount\").greaterThan(100)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"amount > 100\"\n
"},{"location":"setup/validation/basic-validation/#greater-than-or-equal","title":"Greater Than Or Equal","text":"

Ensure all data in column is greater than or equal to certain value.

JavaScalaYAML 
validation().col(\"amount\").greaterThanOrEqual(100)\n
validation.col(\"amount\").greaterThanOrEqual(100)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"amount >= 100\"\n
"},{"location":"setup/validation/basic-validation/#between","title":"Between","text":"

Ensure all data in column is between two values.

JavaScalaYAML 
validation().col(\"amount\").between(100, 200)\n
validation.col(\"amount\").between(100, 200)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"amount BETWEEN 100 AND 200\"\n
"},{"location":"setup/validation/basic-validation/#not-between","title":"Not Between","text":"

Ensure all data in column is not between two values.

JavaScalaYAML 
validation().col(\"amount\").notBetween(100, 200)\n
validation.col(\"amount\").notBetween(100, 200)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"amount NOT BETWEEN 100 AND 200\"\n
"},{"location":"setup/validation/basic-validation/#in","title":"In","text":"

Ensure all data in column is in set of defined values.

JavaScalaYAML 
validation().col(\"status\").in(\"open\", \"closed\")\n
validation.col(\"status\").in(\"open\", \"closed\")\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"status IN ('open', 'closed')\"\n
"},{"location":"setup/validation/basic-validation/#matches","title":"Matches","text":"

Ensure all data in column matches certain regex expression.

JavaScalaYAML 
validation().col(\"account_id\").matches(\"ACC[0-9]{8}\")\n
validation.col(\"account_id\").matches(\"ACC[0-9]{8}\")\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"REGEXP(account_id, ACC[0-9]{8})\"\n
"},{"location":"setup/validation/basic-validation/#not-matches","title":"Not Matches","text":"

Ensure all data in column does not match certain regex expression.

JavaScalaYAML 
validation().col(\"account_id\").notMatches(\"^acc.*\")\n
validation.col(\"account_id\").notMatches(\"^acc.*\")\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"!REGEXP(account_id, '^acc.*')\"\n
"},{"location":"setup/validation/basic-validation/#starts-with","title":"Starts With","text":"

Ensure all data in column starts with certain string. Column has to have type string.

JavaScalaYAML 
validation().col(\"account_id\").startsWith(\"ACC\")\n
validation.col(\"account_id\").startsWith(\"ACC\")\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"STARTSWITH(account_id, 'ACC')\"\n
"},{"location":"setup/validation/basic-validation/#not-starts-with","title":"Not Starts With","text":"

Ensure all data in column does not start with certain string. Column has to have type string.

JavaScalaYAML 
validation().col(\"account_id\").notStartsWith(\"ACC\")\n
validation.col(\"account_id\").notStartsWith(\"ACC\")\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"!STARTSWITH(account_id, 'ACC')\"\n
"},{"location":"setup/validation/basic-validation/#ends-with","title":"Ends With","text":"

Ensure all data in column ends with certain string. Column has to have type string.

JavaScalaYAML 
validation().col(\"account_id\").endsWith(\"ACC\")\n
validation.col(\"account_id\").endsWith(\"ACC\")\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"ENDWITH(account_id, 'ACC')\"\n
"},{"location":"setup/validation/basic-validation/#not-ends-with","title":"Not Ends With","text":"

Ensure all data in column does not end with certain string. Column has to have type string.

JavaScalaYAML 
validation().col(\"account_id\").notEndsWith(\"ACC\")\n
validation.col(\"account_id\").notEndsWith(\"ACC\")\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"!ENDWITH(account_id, 'ACC')\"\n
"},{"location":"setup/validation/basic-validation/#size","title":"Size","text":"

Ensure all data in column has certain size. Column has to have type array or map.

JavaScalaYAML 
validation().col(\"transactions\").size(5)\n
validation.col(\"transactions\").size(5)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"SIZE(transactions, 5)\"\n
"},{"location":"setup/validation/basic-validation/#not-size","title":"Not Size","text":"

Ensure all data in column does not have certain size. Column has to have type array or map.

JavaScalaYAML 
validation().col(\"transactions\").notSize(5)\n
validation.col(\"transactions\").notSize(5)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"SIZE(transactions) != 5\"\n
"},{"location":"setup/validation/basic-validation/#less-than-size","title":"Less Than Size","text":"

Ensure all data in column has size less than certain value. Column has to have type array or map.

JavaScalaYAML 
validation().col(\"transactions\").lessThanSize(5)\n
validation.col(\"transactions\").lessThanSize(5)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"SIZE(transactions) < 5\"\n
"},{"location":"setup/validation/basic-validation/#less-than-or-equal-size","title":"Less Than Or Equal Size","text":"

Ensure all data in column has size less than or equal to certain value. Column has to have type array or map.

JavaScalaYAML 
validation().col(\"transactions\").lessThanOrEqualSize(5)\n
validation.col(\"transactions\").lessThanOrEqualSize(5)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"SIZE(transactions) <= 5\"\n
"},{"location":"setup/validation/basic-validation/#greater-than-size","title":"Greater Than Size","text":"

Ensure all data in column has size greater than certain value. Column has to have type array or map.

JavaScalaYAML 
validation().col(\"transactions\").greaterThanSize(5)\n
validation.col(\"transactions\").greaterThanSize(5)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"SIZE(transactions) > 5\"\n
"},{"location":"setup/validation/basic-validation/#greater-than-or-equal-size","title":"Greater Than Or Equal Size","text":"

Ensure all data in column has size greater than or equal to certain value. Column has to have type array or map.

JavaScalaYAML 
validation().col(\"transactions\").greaterThanOrEqualSize(5)\n
validation.col(\"transactions\").greaterThanOrEqualSize(5)\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"SIZE(transactions) >= 5\"\n
"},{"location":"setup/validation/basic-validation/#luhn-check","title":"Luhn Check","text":"

Ensure all data in column passes luhn check. Luhn check is used to validate credit card numbers and certain identification numbers (see here for more details).

JavaScalaYAML 
validation().col(\"credit_card\").luhnCheck()\n
validation.col(\"credit_card\").luhnCheck\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"LUHN_CHECK(credit_card)\"\n
"},{"location":"setup/validation/basic-validation/#has-type","title":"Has Type","text":"

Ensure all data in column has certain data type.

JavaScalaYAML 
validation().col(\"id\").hasType(\"string\")\n
validation.col(\"id\").hasType(\"string\")\n
---\nname: \"account_checks\"\ndataSources:\n  ...\n    validations:\n      - expr: \"TYPEOF(id) == 'string'\"\n
"},{"location":"setup/validation/basic-validation/#expression","title":"Expression","text":"

Ensure all data in column adheres to SQL expression defined that returns back a boolean. You can define complex logic in here that could combine multiple columns.

For example, CASE WHEN status == 'open' THEN balance > 0 ELSE balance == 0 END would check all rows with status open to have balance greater than 0, otherwise, check the balance is 0.

JavaScalaYAML 
var csvTxns = csv(\"transactions\", \"/tmp/csv\", Map.of(\"header\", \"true\"))\n  .validations(\n    validation().expr(\"amount < 100\"),\n    validation().expr(\"year == 2021\").errorThreshold(0.1),  //equivalent to if error percentage is > 10%, then fail\n    validation().expr(\"REGEXP_LIKE(name, 'Peter .*')\").errorThreshold(200)  //equivalent to if number of errors is > 200, then fail\n  );\n\nvar conf = configuration().enableValidation(true);\n
val csvTxns = csv(\"transactions\", \"/tmp/csv\", Map(\"header\" -> \"true\"))\n  .validations(\n    validation.expr(\"amount < 100\"),\n    validation.expr(\"year == 2021\").errorThreshold(0.1),  //equivalent to if error percentage is > 10%, then fail\n    validation.expr(\"REGEXP_LIKE(name, 'Peter .*')\").errorThreshold(200)  //equivalent to if number of errors is > 200, then fail\n  )\n\nval conf = configuration.enableValidation(true)\n
---\nname: \"account_checks\"\ndataSources:\n  transactions:\n    options:\n      path: \"/tmp/csv\"\n    validations:\n      - expr: \"amount < 100\"\n      - expr: \"year == 2021\"\n        errorThreshold: 0.1   #equivalent to if error percentage is > 10%, then fail\n      - expr: \"REGEXP_LIKE(name, 'Peter .*')\"\n        errorThreshold: 200   #equivalent to if number of errors is > 200, then fail\n        description: \"Should be lots of Peters\"\n\n#enableValidation inside application.conf\n
"},{"location":"setup/validation/group-by-validation/","title":"Group By Validation","text":"

If you want to run aggregations based on a particular set of columns, you can do so via group by validations. An example would be checking that the sum of amount is less than 1000 per account_id, year. The validations applied can be one of the validations from above.

"},{"location":"setup/validation/group-by-validation/#sum","title":"Sum","text":"

Check the sum of a columns values for each group adheres to validation.

JavaScala 
validation().groupBy(\"account_id\", \"year\").sum(\"amount\").lessThan(1000)\n
validation.groupBy(\"account_id\", \"year\").sum(\"amount\").lessThan(1000)\n
"},{"location":"setup/validation/group-by-validation/#count","title":"Count","text":"

Check the count for each group adheres to validation.

JavaScala 
validation().groupBy(\"account_id\", \"year\").count(\"amount\").lessThan(10)\n
validation.groupBy(\"account_id\", \"year\").count(\"amount\").lessThan(10)\n
"},{"location":"setup/validation/group-by-validation/#min","title":"Min","text":"

Check the min for each group adheres to validation.

JavaScala 
validation().groupBy(\"account_id\", \"year\").min(\"amount\").greaterThan(0)\n
validation.groupBy(\"account_id\", \"year\").min(\"amount\").greaterThan(0)\n
"},{"location":"setup/validation/group-by-validation/#max","title":"Max","text":"

Check the max for each group adheres to validation.

JavaScala 
validation().groupBy(\"account_id\", \"year\").max(\"amount\").lessThanOrEqual(100)\n
validation.groupBy(\"account_id\", \"year\").max(\"amount\").lessThanOrEqual(100)\n
"},{"location":"setup/validation/group-by-validation/#average","title":"Average","text":"

Check the average for each group adheres to validation.

JavaScala 
validation().groupBy(\"account_id\", \"year\").avg(\"amount\").between(40, 60)\n
validation.groupBy(\"account_id\", \"year\").avg(\"amount\").between(40, 60)\n
"},{"location":"setup/validation/validation/","title":"Validations","text":"

Validations can be used to run data checks after you have run the data generator or even as a standalone task. A report summarising the success or failure of the validations is produced and can be examined for further investigation.

  • Basic - Basic column level validations
  • Group by/Aggregate - Run aggregates over grouped data, then validate
  • [Relationship (Coming soon)] - Ensure record values exist in other datasets based on relationships
  • [Data Profile (Coming soon)] - Score how close the data profile of generated data is against the target data profile

Currently, SQL expression validations are supported (can see here for reference what other expressions are valid), but will later be extended out to supported other validations such as aggregates (group by account_number, sum of amounts should be greater than 100), ordering (transaction dates should be in descending order), relationships (at least one transaction per account_number) or data profiling (how close produced data profile is to expected data profile).

"},{"location":"setup/validation/validation/#define-validations","title":"Define Validations","text":"

Full example validation can be found below. For more details, check out each of the subsections defined further below.

JavaScalaYAML 
var csvTxns = csv(\"transactions\", \"/tmp/csv\", Map.of(\"header\", \"true\"))\n  .validations(\n    validation().col(\"amount\").lessThan(100),\n    validation().col(\"year\").isEqual(2021).errorThreshold(0.1),  //equivalent to if error percentage is > 10%, then fail\n    validation().col(\"name\").matches(\"Peter .*\").errorThreshold(200)  //equivalent to if number of errors is > 200, then fail\n  )\n  .validationWait(waitCondition().pause(1));\n\nvar conf = configuration().enableValidation(true);\n
val csvTxns = csv(\"transactions\", \"/tmp/csv\", Map(\"header\" -> \"true\"))\n  .validations(\n    validation.col(\"amount\").lessThan(100),\n    validation.col(\"year\").isEqual(2021).errorThreshold(0.1),  //equivalent to if error percentage is > 10%, then fail\n    validation.col(\"name\").matches(\"Peter .*\").errorThreshold(200)  //equivalent to if number of errors is > 200, then fail\n  )  \n  .validationWait(waitCondition.pause(1))\n\nval conf = configuration.enableValidation(true)\n
---\nname: \"account_checks\"\ndataSources:\n  transactions:\n    options:\n      path: \"/tmp/csv\"\n    validations:\n      - expr: \"amount < 100\"\n      - expr: \"year == 2021\"\n        errorThreshold: 0.1   #equivalent to if error percentage is > 10%, then fail\n      - expr: \"REGEXP_LIKE(name, 'Peter .*')\"\n        errorThreshold: 200   #equivalent to if number of errors is > 200, then fail\n        description: \"Should be lots of Peters\"\n    waitCondition:\n      pauseInSeconds: 1\n
"},{"location":"setup/validation/validation/#wait-condition","title":"Wait Condition","text":"

Once data has been generated, you may want to wait for a certain condition to be met before starting the data validations. This can be via:

  • Pause for seconds
  • When file is available
  • Data exists
  • Webhook
"},{"location":"setup/validation/validation/#pause","title":"Pause","text":"JavaScalaYAML 
var csvTxns = csv(\"transactions\", \"/tmp/csv\", Map.of(\"header\", \"true\"))\n  .validationWait(waitCondition().pause(1));\n
val csvTxns = csv(\"transactions\", \"/tmp/csv\", Map(\"header\" -> \"true\"))\n  .validationWait(waitCondition.pause(1))\n
---\nname: \"account_checks\"\ndataSources:\n  transactions:\n    options:\n      path: \"/tmp/csv\"\n    waitCondition:\n      pauseInSeconds: 1\n
"},{"location":"setup/validation/validation/#data-exists","title":"Data exists","text":"JavaScalaYAML 
var csvTxns = csv(\"transactions\", \"/tmp/csv\", Map.of(\"header\", \"true\"))\n  .validationWaitDataExists(\"updated_date > DATE('2023-01-01')\");\n
val csvTxns = csv(\"transactions\", \"/tmp/csv\", Map(\"header\" -> \"true\"))\n  .validationWaitDataExists(\"updated_date > DATE('2023-01-01')\")\n
---\nname: \"account_checks\"\ndataSources:\n  transactions:\n    options:\n      path: \"/tmp/csv\"\n    waitCondition:\n      dataSourceName: \"transactions\"\n      options:\n        path: \"/tmp/csv\"\n      expr: \"updated_date > DATE('2023-01-01')\"\n
"},{"location":"setup/validation/validation/#webhook","title":"Webhook","text":"JavaScalaYAML 
var csvTxns = csv(\"transactions\", \"/tmp/csv\", Map.of(\"header\", \"true\"))\n  .validationWait(waitCondition().webhook(\"http://localhost:8080/finished\")); //by default, GET request successful when 200 status code\n\n//or\n\nvar csvTxnsWithStatusCodes = csv(\"transactions\", \"/tmp/csv\", Map.of(\"header\", \"true\"))\n  .validationWait(waitCondition().webhook(\"http://localhost:8080/finished\", \"GET\", 200, 202));  //successful if 200 or 202 status code\n\n//or\n\nvar csvTxnsWithExistingHttpConnection = csv(\"transactions\", \"/tmp/csv\", Map.of(\"header\", \"true\"))\n  .validationWait(waitCondition().webhook(\"my_http\", \"http://localhost:8080/finished\"));  //use connection configuration from existing 'my_http' connection definition\n
val csvTxns = csv(\"transactions\", \"/tmp/csv\", Map(\"header\" -> \"true\"))\n  .validationWait(waitCondition.webhook(\"http://localhost:8080/finished\"))  //by default, GET request successful when 200 status code\n\n//or\n\nval csvTxnsWithStatusCodes = csv(\"transactions\", \"/tmp/csv\", Map(\"header\" -> \"true\"))\n  .validationWait(waitCondition.webhook(\"http://localhost:8080/finished\", \"GET\", 200, 202)) //successful if 200 or 202 status code\n\n//or\n\nval csvTxnsWithExistingHttpConnection = csv(\"transactions\", \"/tmp/csv\", Map(\"header\" -> \"true\"))\n  .validationWait(waitCondition.webhook(\"my_http\", \"http://localhost:8080/finished\")) //use connection configuration from existing 'my_http' connection definition\n
---\nname: \"account_checks\"\ndataSources:\n  transactions:\n    options:\n      path: \"/tmp/csv\"\n    waitCondition:\n      url: \"http://localhost:8080/finished\" #by default, GET request successful when 200 status code\n\n#or\n\n---\nname: \"account_checks\"\ndataSources:\n  transactions:\n    options:\n      path: \"/tmp/csv\"\n    waitCondition:\n      url: \"http://localhost:8080/finished\"\n      method: \"GET\"\n      statusCodes: [200, 202] #successful if 200 or 202 status code\n\n#or\n\n---\nname: \"account_checks\"\ndataSources:\n  transactions:\n    options:\n      path: \"/tmp/csv\"\n    waitCondition:\n      dataSourceName: \"my_http\" #use connection configuration from existing 'my_http' connection definition\n      url: \"http://localhost:8080/finished\"\n
"},{"location":"setup/validation/validation/#file-available","title":"File available","text":"JavaScalaYAML 
var csvTxns = csv(\"transactions\", \"/tmp/csv\", Map.of(\"header\", \"true\"))\n  .validationWait(waitCondition().file(\"/tmp/json\"));\n
val csvTxns = csv(\"transactions\", \"/tmp/csv\", Map.of(\"header\", \"true\"))\n  .validationWait(waitCondition.file(\"/tmp/json\"))\n
---\nname: \"account_checks\"\ndataSources:\n  transactions:\n    options:\n      path: \"/tmp/csv\"\n    waitCondition:\n      path: \"/tmp/json\"\n
"},{"location":"setup/validation/validation/#report","title":"Report","text":"

Once run, it will produce a report like this.

"},{"location":"use-case/business-value/","title":"Business Value","text":"

Below is a list of the business related benefits from using Data Caterer which may be applicable for your use case.

Problem Data Caterer Solution Resources Effects Reliable test data creation - Profile existing data- Create scenarios- Generate data Software Engineers, QA, Testers Cost reduction in labor, more time spent on development, more bugs caught before production Faster development cycles - Generate data in local, test, UAT, pre-prod- Run different scenarios Software Engineers, QA, Testers More defects caught in lower environments, features pushed to production faster, common framework used across all environments Data compliance - Profiling existing data- Generate based on metadata- No complex masking- No production data used in lower environments Audit and compliance No chance for production data breaches Storage costs - Delete generated data- Test specific scenarios Infrastructure Lower data storage costs, less time spent on data management and clean up Schema evolution - Create metadata from data sources- Generate data based off fresh metadata Software Engineers, QA, Testers Less time spent altering tests due to schema changes, ease of use between environments and application versions"},{"location":"use-case/comparison/","title":"Comparison to similar tools","text":"

I have tried to include all the companies found in the list here from Mostly AI blog post and used information that is publicly available.

The companies/products not shown below either have:

  • a website with insufficient information about the technology side of data generation/validation
  • no/little documentation
  • don't have a free, no sign-up version of their app to use
"},{"location":"use-case/comparison/#data-generation","title":"Data Generation","text":"Tool Description Cost Pros Cons Clearbox AI Python based data generation tool via ML Unclear Python SDK UI interface Detect private data Report generation Batch data only No data clean up Limited/no documentation Curiosity Software Platform solution for test data management Unclear Extensive documentation Generate data based off test cases UI interface Web/API/UI/mobile testing No quick start No SDK Many components that may not be required No event generation support DataCebo Synthetic Data Vault Python based data generation tool via ML Unclear Python SDK Report generation Data quality checks Business logic constraints No data connection support No data clean up No foreign key support Datafaker Realistic data generation library Free SDK for many languages Simple, easy to use Extensible Open source Generate realistic values No data connection support No data clean up No validation No foreign key support DBLDatagen Python based data generation tool Free Python SDK Open source Good documentation Customisable scenarios Customisable column generation Generate from existing data/schemas Plugin third-party libraries Limited support if issues Code required No data clean up No data validation Gatling HTTP API load testing tool Free (Open Source)Gatling Enterprise, usage based, starts from \u20ac89 per month, 1 user, 6.25 hours of testing Kotlin, Java & Scala SDK Widely used Open source Clear documentation Extensive testing/validation support Customisable scenarios Report generation Only supports HTTP, JMS and JDBC No data clean up Data feeders not based off metadata Gretel Python based data generation tool via ML Usage based, starts from $295 per month, $2.20 per credit, assumed USD CLI & Python SDK UI interface Training and re-use of models Detect private data Customisable scenarios Batch data only No relationships between data sources Only simple foreign key relations defined No data clean up Charge by usage Howso Python based data generation tool via ML Unclear Python SDK Playground to try Open source library Customisable scenarios No support for data sources No data validation No data clean up Mostly AI Python based data generation tool via ML Usage based, Enterprise 1 user, 100 columns, 100K rows $3,100 per month, assumed USD Report generation Non-technical users can use UI Customisable scenarios Charge by usage Batch data only No data clean up Confusing use of 'smart select' for multiple foreign keys Limited custom column generation logic Multiple deployment components No SDK Octopize Python based data generation tool via ML Unclear Python & R SDK Report generation API for metadata Customisable scenarios Input data source is only CSV Multiple manual steps before starting Quickstart is not a quickstart Documentation lacks code examples Synthesized Python based data generation tool via ML Unclear CLI & Python SDK API for metadata IDE setup Data quality checks Not sure what is SDK & TDK Charge by usage No report of what was generated No relationships between data sources Tonic Platform solution for generating data Unclear UI interface Good documentation Detect private data Support for encrypted columns Report generation Alerting Batch data only Multiple deployment components No relationships between data sources No data validation No data clean up No SDK (only API) Difficult to embed complex business logic YData Python based data generation tool via ML. Platform solution as well Unclear Python SDK Open source Detect private data Compare datasets Report generation No data connection support Batch data only No data clean up Separate data generation and data validation No foreign key support"},{"location":"use-case/comparison/#use-of-ml-models","title":"Use of ML models","text":"

You may notice that the majority of data generators use machine learning (ML) models to learn from your existing datasets to generate new data. Below are some pros and cons to the approach.

Pros

  • Simple setup
  • Ability to reproduce complex logic
  • Flexible to accept all types of data

Cons

  • Long time for model learning
  • Black box of logic
  • Maintain, store and update of ML models
  • Restriction on input data lengths
  • May not maintain referential integrity
  • Require deeper understanding of ML models for fine-tuning
  • Accuracy may be worse than non-ML models
"},{"location":"use-case/roadmap/","title":"Roadmap","text":"
  • Support for other data sources
    • GCP and Azure related data services ( cloud storage)
    • Deltalake
    • RabbitMQ
    • ActiveMQ
    • MongoDB
    • Airflow
    • DBT
  • Further support for metadata discovery
    • HTTP (OpenAPI spec)
    • JMS
    • Read from samples
  • API for developers and testers
    • Scala
    • Java
  • UI for metadata and data generation
  • Report for data generated and validation rules
  • Metadata stored in database
  • Integration with existing metadata services (i.e. Amundsen, Datahub, Schema Registry, DBT)
    • Populate metadata back to metadata services
    • OpenLineage metadata (Marquez)
    • OpenMetadata
  • Integration with existing data validations
    • Great Expectation
    • DBT constraints
    • SodaCL
    • MonteCarlo
  • Suggest data validations
  • Data dictionary
    • Business definitions of fields that can be referenced for metadata across all data sources
  • Verification rules after data generation
  • Validation waiting conditions
    • Webhook
    • File exists
    • Data exists via SQL expression
    • Pause
  • Extend validation types
    • Aggregates (sum of amount per account is > 500)
    • Ordering (transactions are ordered by date)
    • Relationship (at least one account entry in history table per account in accounts table)
    • Data profile (how close the generated data profile is compared to the expected data profile)
  • Extend count
    • Cover all possible cases (i.e. record for each combination of oneOf values, positive/negative values etc.)
    • Similar to edge cases
  • Alerting
    • Slack
    • Email
  • Overriding tasks
    • Can customise tasks without copying whole schema definitions
    • Easier to create scenarios
  • Gradle plugin
  • Metadata improvements
    • PII detection (can integrate with Presidio)
    • Relationship detection across data sources
    • SQL generation
    • Ordering information
  • Code generation
  • Schema generation from Scala/Java class
  • Ordering within data sources that support order for insertion
  • Clean up data in consumer data sinks
  • Trial app to try out all features
"},{"location":"use-case/use-case/","title":"Use cases","text":""},{"location":"use-case/use-case/#replicate-production-in-lower-environment","title":"Replicate production in lower environment","text":"

Having a stable and reliable test environment is a challenge for a number of companies, especially where teams are asynchronously deploying and testing changes at faster rates. Data Caterer can help alleviate these issues by doing the following:

  1. Generates data with the latest schema changes and production like field values
  2. Run as a job on a daily/regular basis to replicate production traffic or data flows
  3. Validate data to ensure your system runs as expected
  4. Clean up data to avoid build up of generated data

"},{"location":"use-case/use-case/#local-development","title":"Local development","text":"

Similar to the above, being able to replicate production like data in your local environment can be key to developing more reliable code as you can test directly against data in your local computer. This has a number of benefits including:

  1. Fewer assumptions or ambiguities when the developer codes
  2. Direct feedback loop in local computer rather than waiting for test environment for more reliable test data
  3. No domain expertise required to understand the data
  4. Easy for new developers to be onboarded and developing/testing code for jobs/services
"},{"location":"use-case/use-case/#systemintegration-testing","title":"System/integration testing","text":"

When working with third-party, external or internal data providers, it can be difficult to have all setup ready to produce reliable data that abides by relationship contracts between each of the systems. You have to rely on these data providers in order for you to run your tests which may not align to their priorities. With Data Caterer, you can generate the same data that they would produce, along with maintaining referential integrity across the data providers, so that you can run your tests without relying on their systems being up and reliable in their corresponding lower environments.

"},{"location":"use-case/use-case/#scenario-testing","title":"Scenario testing","text":"

If you want to set up particular data scenarios, you can customise the generated data to fit your scenario. Once the data gets generated and is consumed, you can also run validations to ensure your system has consumed the data correctly. These scenarios can be put together from existing tasks or data sources can be enabled/disabled based on your requirement. Built into Data Caterer and controlled via feature flags, is the ability to test edge cases based on the data type of the fields used for data generation (enableEdgeCases flag within <field>.generator.options, see more here).

"},{"location":"use-case/use-case/#data-debugging","title":"Data debugging","text":"

When data related issues occur in production, it may be difficult to replicate in a lower or local environment. It could be related to specific fields not containing expected results, size of data is too large or missing corresponding referenced data. This becomes key to resolving the issue as you can directly code against the exact data scenario and have confidence that your code changes will fix the problem. Data Caterer can be used to generate the appropriate data in whichever environment you want to test your changes against.

"},{"location":"use-case/use-case/#data-profiling","title":"Data profiling","text":"

When using Data Caterer with the feature flag enableGeneratePlanAndTasks enabled (see here), metadata relating all the fields defined in the data sources you have configured will be generated via data profiling. You can run this as a standalone job (can disable enableGenerateData) so that you can focus on the profile of the data you are utilising. This can be run against your production data sources to ensure the metadata can be used to accurately generate data in other environments. This is a key feature of Data Caterer as no direct production connections need to be maintained to generate data in other environments (which can lead to serious concerns about data security as seen here).

"},{"location":"use-case/use-case/#schema-gathering","title":"Schema gathering","text":"

When using Data Caterer with the feature flag enableGeneratePlanAndTasks enabled (see here), all schemas of the data sources defined will be tracked in a common format (as tasks). This data, along with the data profiling metadata, could then feed back into your schema registries to help keep them up to date with your system.

"}]} \ No newline at end of file diff --git a/setup/advanced/advanced/index.html b/setup/advanced/advanced/index.html new file mode 100644 index 00000000..f92936d2 --- /dev/null +++ b/setup/advanced/advanced/index.html @@ -0,0 +1,2311 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Advanced - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Advanced use cases

+

Special data formats

+

There are many options available for you to use when you have a scenario when data has to be a certain format.

+
    +
  1. Create expression datafaker
      +
    1. Can be used to create names, addresses, or anything that can be found + under here
      2. +
    +
    2. +
  2. Create regex
    3. +
+

Foreign keys across data sets

+

Multiple data source foreign key example

+

Details for how you can configure foreign keys can be found here.

+

Edge cases

+

For each given data type, there are edge cases which can cause issues when your application processes the data. +This can be controlled at a column level by including the following flag in the generator options:

+
+
+
+
field()
+  .name("amount")
+  .type(DoubleType.instance())
+  .enableEdgeCases(true)
+  .edgeCaseProbability(0.1)
+
+
+
+
field
+  .name("amount")
+  .`type`(DoubleType)
+  .enableEdgeCases(true)
+  .edgeCaseProbability(0.1)
+
+
+
+
fields:
+  - name: "amount"
+    type: "double"
+    generator:
+      type: "random"
+      options:
+        enableEdgeCases: "true"
+        edgeCaseProb: 0.1
+
+
+
+
+

If you want to know all the possible edge cases for each data +type, can check the documentation here.

+

Scenario testing

+

You can create specific scenarios by adjusting the metadata found in the plan and tasks to your liking.
+For example, if you had two data sources, a Postgres database and a parquet file, and you wanted to save account data +into Postgres and transactions related to those accounts into a parquet file. +You can alter the status column in the account data to only generate open accounts +and define a foreign key between Postgres and parquet to ensure the same account_id is being used.
+Then in the parquet task, define 1 to 10 transactions per account_id to be generated.

+

Postgres account generation example task
+Parquet transaction generation example task
+Plan

+

Cloud storage

+

Data source

+

If you want to save the file types CSV, JSON, Parquet or ORC into cloud storage, you can do so via adding extra +configurations. Below is an example for S3.

+
+
+
+
var csvTask = csv("my_csv", "s3a://my-bucket/csv/accounts")
+  .schema(
+    field().name("account_id"),
+    ...
+  );
+
+var s3Configuration = configuration()
+  .runtimeConfig(Map.of(
+    "spark.hadoop.fs.s3a.directory.marker.retention", "keep",
+    "spark.hadoop.fs.s3a.bucket.all.committer.magic.enabled", "true",
+    "spark.hadoop.fs.defaultFS", "s3a://my-bucket",
+    //can change to other credential providers as shown here
+    //https://hadoop.apache.org/docs/stable/hadoop-aws/tools/hadoop-aws/index.html#Changing_Authentication_Providers
+    "spark.hadoop.fs.s3a.aws.credentials.provider", "org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider",
+    "spark.hadoop.fs.s3a.access.key", "access_key",
+    "spark.hadoop.fs.s3a.secret.key", "secret_key"
+  ));
+
+execute(s3Configuration, csvTask);
+
+
+
+
val csvTask = csv("my_csv", "s3a://my-bucket/csv/accounts")
+  .schema(
+    field.name("account_id"),
+    ...
+  )
+
+val s3Configuration = configuration
+  .runtimeConfig(Map(
+    "spark.hadoop.fs.s3a.directory.marker.retention" -> "keep",
+    "spark.hadoop.fs.s3a.bucket.all.committer.magic.enabled" -> "true",
+    "spark.hadoop.fs.defaultFS" -> "s3a://my-bucket",
+    //can change to other credential providers as shown here
+    //https://hadoop.apache.org/docs/stable/hadoop-aws/tools/hadoop-aws/index.html#Changing_Authentication_Providers
+    "spark.hadoop.fs.s3a.aws.credentials.provider" -> "org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider",
+    "spark.hadoop.fs.s3a.access.key" -> "access_key",
+    "spark.hadoop.fs.s3a.secret.key" -> "secret_key"
+  ))
+
+execute(s3Configuration, csvTask)
+
+
+
+
folders {
+   generatedPlanAndTaskFolderPath = "s3a://my-bucket/data-caterer/generated"
+   planFilePath = "s3a://my-bucket/data-caterer/generated/plan/customer-create-plan.yaml"
+   taskFolderPath = "s3a://my-bucket/data-caterer/generated/task"
+}
+
+runtime {
+    config {
+        ...
+        #S3
+        "spark.hadoop.fs.s3a.directory.marker.retention" = "keep"
+        "spark.hadoop.fs.s3a.bucket.all.committer.magic.enabled" = "true"
+        "spark.hadoop.fs.defaultFS" = "s3a://my-bucket"
+        #can change to other credential providers as shown here
+        #https://hadoop.apache.org/docs/stable/hadoop-aws/tools/hadoop-aws/index.html#Changing_Authentication_Providers
+        "spark.hadoop.fs.s3a.aws.credentials.provider" = "org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider"
+        "spark.hadoop.fs.s3a.access.key" = "access_key"
+        "spark.hadoop.fs.s3a.secret.key" = "secret_key"
+   }
+}
+
+
+
+
+

Storing plan/task(s)

+

You can generate and store the plan/task files inside either AWS S3, Azure Blob Storage or Google GCS. +This can be controlled via configuration set in the application.conf file where you can set something like the below:

+
+
+
+
configuration()
+  .generatedReportsFolderPath("s3a://my-bucket/data-caterer/generated")
+  .planFilePath("s3a://my-bucket/data-caterer/generated/plan/customer-create-plan.yaml")
+  .taskFolderPath("s3a://my-bucket/data-caterer/generated/task")
+  .runtimeConfig(Map.of(
+    "spark.hadoop.fs.s3a.directory.marker.retention", "keep",
+    "spark.hadoop.fs.s3a.bucket.all.committer.magic.enabled", "true",
+    "spark.hadoop.fs.defaultFS", "s3a://my-bucket",
+    //can change to other credential providers as shown here
+    //https://hadoop.apache.org/docs/stable/hadoop-aws/tools/hadoop-aws/index.html#Changing_Authentication_Providers
+    "spark.hadoop.fs.s3a.aws.credentials.provider", "org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider",
+    "spark.hadoop.fs.s3a.access.key", "access_key",
+    "spark.hadoop.fs.s3a.secret.key", "secret_key"
+  ));
+
+
+
+
configuration
+  .generatedReportsFolderPath("s3a://my-bucket/data-caterer/generated")
+  .planFilePath("s3a://my-bucket/data-caterer/generated/plan/customer-create-plan.yaml")
+  .taskFolderPath("s3a://my-bucket/data-caterer/generated/task")
+  .runtimeConfig(Map(
+    "spark.hadoop.fs.s3a.directory.marker.retention" -> "keep",
+    "spark.hadoop.fs.s3a.bucket.all.committer.magic.enabled" -> "true",
+    "spark.hadoop.fs.defaultFS" -> "s3a://my-bucket",
+    //can change to other credential providers as shown here
+    //https://hadoop.apache.org/docs/stable/hadoop-aws/tools/hadoop-aws/index.html#Changing_Authentication_Providers
+    "spark.hadoop.fs.s3a.aws.credentials.provider" -> "org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider",
+    "spark.hadoop.fs.s3a.access.key" -> "access_key",
+    "spark.hadoop.fs.s3a.secret.key" -> "secret_key"
+  ))
+
+
+
+
folders {
+   generatedPlanAndTaskFolderPath = "s3a://my-bucket/data-caterer/generated"
+   planFilePath = "s3a://my-bucket/data-caterer/generated/plan/customer-create-plan.yaml"
+   taskFolderPath = "s3a://my-bucket/data-caterer/generated/task"
+}
+
+runtime {
+    config {
+        ...
+        #S3
+        "spark.hadoop.fs.s3a.directory.marker.retention" = "keep"
+        "spark.hadoop.fs.s3a.bucket.all.committer.magic.enabled" = "true"
+        "spark.hadoop.fs.defaultFS" = "s3a://my-bucket"
+        #can change to other credential providers as shown here
+        #https://hadoop.apache.org/docs/stable/hadoop-aws/tools/hadoop-aws/index.html#Changing_Authentication_Providers
+        "spark.hadoop.fs.s3a.aws.credentials.provider" = "org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider"
+        "spark.hadoop.fs.s3a.access.key" = "access_key"
+        "spark.hadoop.fs.s3a.secret.key" = "secret_key"
+   }
+}
+
+
+
+
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/configuration/index.html b/setup/configuration/index.html new file mode 100644 index 00000000..b6042878 --- /dev/null +++ b/setup/configuration/index.html @@ -0,0 +1,2476 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Configuration - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Configuration

+

A number of configurations can be made and customised within Data Caterer to help control what gets run and/or where any +metadata gets saved.

+

These configurations are defined from within your Java or Scala class via configuration or for YAML file setup, +application.conf file as seen +here.

+

Flags

+

Flags are used to control which processes are executed when you run Data Caterer.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ConfigDefaultPaidDescription
enableGenerateDatatrueNEnable/disable data generation
enableCounttrueNCount the number of records generated. Can be disabled to improve performance
enableFailOnErrortrueNWhilst saving generated data, if there is an error, it will stop any further data from being generated
enableSaveReportstrueNEnable/disable HTML reports summarising data generated, metadata of data generated (if enableSinkMetadata is enabled) and validation results (if enableValidation is enabled). Sample here
enableSinkMetadatatrueNRun data profiling for the generated data. Shown in HTML reports if enableSaveSinkMetadata is enabled
enableValidationfalseNRun validations as described in plan. Results can be viewed from logs or from HTML report if enableSaveSinkMetadata is enabled. Sample here
enableGeneratePlanAndTasksfalseYEnable/disable plan and task auto generation based off data source connections
enableRecordTrackingfalseYEnable/disable which data records have been generated for any data source
enableDeleteGeneratedRecordsfalseYDelete all generated records based off record tracking (if enableRecordTracking has been set to true)
enableGenerateValidationsfalseYIf enabled, it will generate validations based on the data sources defined.
+
+
+
+
configuration()
+  .enableGenerateData(true)
+  .enableCount(true)
+  .enableFailOnError(true)
+  .enableSaveReports(true)
+  .enableSinkMetadata(true)
+  .enableValidation(false)
+  .enableGeneratePlanAndTasks(false)
+  .enableRecordTracking(false)
+  .enableDeleteGeneratedRecords(false)
+  .enableGenerateValidations(false);
+
+
+
+
configuration
+  .enableGenerateData(true)
+  .enableCount(true)
+  .enableFailOnError(true)
+  .enableSaveReports(true)
+  .enableSinkMetadata(true)
+  .enableValidation(false)
+  .enableGeneratePlanAndTasks(false)
+  .enableRecordTracking(false)
+  .enableDeleteGeneratedRecords(false)
+  .enableGenerateValidations(false)
+
+
+
+
flags {
+  enableCount = false
+  enableCount = ${?ENABLE_COUNT}
+  enableGenerateData = true
+  enableGenerateData = ${?ENABLE_GENERATE_DATA}
+  enableFailOnError = true
+  enableFailOnError = ${?ENABLE_FAIL_ON_ERROR}
+  enableGeneratePlanAndTasks = false
+  enableGeneratePlanAndTasks = ${?ENABLE_GENERATE_PLAN_AND_TASKS}
+  enableRecordTracking = false
+  enableRecordTracking = ${?ENABLE_RECORD_TRACKING}
+  enableDeleteGeneratedRecords = false
+  enableDeleteGeneratedRecords = ${?ENABLE_DELETE_GENERATED_RECORDS}
+  enableGenerateValidations = false
+  enableGenerateValidations = ${?ENABLE_GENERATE_VALIDATIONS}
+}
+
+
+
+
+

Folders

+

Depending on which flags are enabled, there are folders that get used to save metadata, store HTML reports or track the +records generated.

+

These folder pathways can be defined as a cloud storage pathway (i.e. s3a://my-bucket/task).

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ConfigDefaultPaidDescription
planFilePath/opt/app/plan/customer-create-plan.yamlNPlan file path to use when generating and/or validating data
taskFolderPath/opt/app/taskNTask folder path that contains all the task files (can have nested directories)
validationFolderPath/opt/app/validationNValidation folder path that contains all the validation files (can have nested directories)
generatedReportsFolderPath/opt/app/reportNWhere HTML reports get generated that contain information about data generated along with any validations performed
generatedPlanAndTaskFolderPath/tmpYFolder path where generated plan and task files will be saved
recordTrackingFolderPath/opt/app/record-trackingYWhere record tracking parquet files get saved
+
+
+
+
configuration()
+  .planFilePath("/opt/app/custom/plan/postgres-plan.yaml")
+  .taskFolderPath("/opt/app/custom/task")
+  .validationFolderPath("/opt/app/custom/validation")
+  .generatedReportsFolderPath("/opt/app/custom/report")
+  .generatedPlanAndTaskFolderPath("/opt/app/custom/generated")
+  .recordTrackingFolderPath("/opt/app/custom/record-tracking");
+
+
+
+
configuration
+  .planFilePath("/opt/app/custom/plan/postgres-plan.yaml")
+  .taskFolderPath("/opt/app/custom/task")
+  .validationFolderPath("/opt/app/custom/validation")
+  .generatedReportsFolderPath("/opt/app/custom/report")
+  .generatedPlanAndTaskFolderPath("/opt/app/custom/generated")
+  .recordTrackingFolderPath("/opt/app/custom/record-tracking")
+
+
+
+
folders {
+  planFilePath = "/opt/app/custom/plan/postgres-plan.yaml"
+  planFilePath = ${?PLAN_FILE_PATH}
+  taskFolderPath = "/opt/app/custom/task"
+  taskFolderPath = ${?TASK_FOLDER_PATH}
+  validationFolderPath = "/opt/app/custom/validation"
+  validationFolderPath = ${?VALIDATION_FOLDER_PATH}
+  generatedReportsFolderPath = "/opt/app/custom/report"
+  generatedReportsFolderPath = ${?GENERATED_REPORTS_FOLDER_PATH}
+  generatedPlanAndTaskFolderPath = "/opt/app/custom/generated"
+  generatedPlanAndTaskFolderPath = ${?GENERATED_PLAN_AND_TASK_FOLDER_PATH}
+  recordTrackingFolderPath = "/opt/app/custom/record-tracking"
+  recordTrackingFolderPath = ${?RECORD_TRACKING_FOLDER_PATH}
+}
+
+
+
+
+

Metadata

+

When metadata gets generated, there are some configurations that can be altered to help with performance or accuracy +related issues. +Metadata gets generated from two processes: 1) if enableGeneratePlanAndTasks or 2) if enableSinkMetadata are +enabled.

+

During the generation of plan and tasks, data profiling is used to create the metadata for each of the fields defined in +the data source. +You may face issues if the number of records in the data source is large as data profiling is an expensive task. +Similarly, it can be expensive +when analysing the generated data if the number of records generated is large.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ConfigDefaultPaidDescription
numRecordsFromDataSource10000YNumber of records read in from the data source that could be used for data profiling
numRecordsForAnalysis10000YNumber of records used for data profiling from the records gathered in numRecordsFromDataSource
oneOfMinCount1000YMinimum number of records required before considering if a field can be of type oneOf
oneOfDistinctCountVsCountThreshold0.2YThreshold ratio to determine if a field is of type oneOf (i.e. a field called status that only contains open or closed. Distinct count = 2, total count = 10, ratio = 2 / 10 = 0.2 therefore marked as oneOf)
numGeneratedSamples10NNumber of sample records from generated data to take. Shown in HTML report
+
+
+
+
configuration()
+  .numRecordsFromDataSourceForDataProfiling(10000)
+  .numRecordsForAnalysisForDataProfiling(10000)
+  .oneOfMinCount(1000)
+  .oneOfDistinctCountVsCountThreshold(1000)
+  .numGeneratedSamples(10);
+
+
+
+
configuration
+  .numRecordsFromDataSourceForDataProfiling(10000)
+  .numRecordsForAnalysisForDataProfiling(10000)
+  .oneOfMinCount(1000)
+  .oneOfDistinctCountVsCountThreshold(1000)
+  .numGeneratedSamples(10)
+
+
+
+
metadata {
+  numRecordsFromDataSource = 10000
+  numRecordsForAnalysis = 10000
+  oneOfMinCount = 1000
+  oneOfDistinctCountVsCountThreshold = 0.2
+  numGeneratedSamples = 10
+}
+
+
+
+
+

Generation

+

When generating data, you may have some limitations such as limited CPU or memory, large number of data sources, or data +sources prone to failure under load. +To help alleviate these issues or speed up performance, you can control the number of records that get generated in each +batch.

+ + + + + + + + + + + + + + + + + + + + + + + +
ConfigDefaultPaidDescription
numRecordsPerBatch100000NNumber of records across all data sources to generate per batch
numRecordsPerStepNOverrides the count defined in each step with this value if defined (i.e. if set to 1000, for each step, 1000 records will be generated)
+
+
+
+
configuration()
+  .numRecordsPerBatch(100000)
+  .numRecordsPerStep(1000);
+
+
+
+
configuration
+  .numRecordsPerBatch(100000)
+  .numRecordsPerStep(1000)
+
+
+
+
generation {
+  numRecordsPerBatch = 100000
+  numRecordsPerStep = 1000
+}
+
+
+
+
+

Runtime

+

Given Data Caterer uses Spark as the base framework for data processing, you can configure the job as to your +specifications via configuration as seen here.

+
+
+
+
configuration()
+  .master("local[*]")
+  .runtimeConfig(Map.of("spark.driver.cores", "5"))
+  .addRuntimeConfig("spark.driver.memory", "10g");
+
+
+
+
configuration
+  .master("local[*]")
+  .runtimeConfig(Map("spark.driver.cores" -> "5"))
+  .addRuntimeConfig("spark.driver.memory" -> "10g")
+
+
+
+
runtime {
+  master = "local[*]"
+  master = ${?DATA_CATERER_MASTER}
+  config {
+    "spark.driver.cores" = "5"
+    "spark.driver.memory" = "10g"
+  }
+}
+
+
+
+
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/connection/connection/index.html b/setup/connection/connection/index.html new file mode 100644 index 00000000..9828e86d --- /dev/null +++ b/setup/connection/connection/index.html @@ -0,0 +1,2750 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Connection - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Data Source Connections

+

Details of all the connection configuration supported can be found in the below subsections for each type of connection.

+

These configurations can be done via API or from configuration. Examples of both are shown for each data source below.

+

Supported Data Connections

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Data Source TypeData SourcePaid
DatabasePostgres, MySQL, CassandraN (Postgres), Y (rest)
FileCSV, JSON, ORC, ParquetN
MessagingKafka, SolaceY
HTTPREST APIY
MetadataMarquez, OpenMetadata, OpenAPI/SwaggerY
+

API

+

All connection details require a name. Depending on the data source, you can define additional options which may be used +by the driver or connector for connecting to the data source.

+

Configuration file

+

All connection details follow the same pattern.

+
<connection format> {
+    <connection name> {
+        <key> = <value>
+    }
+}
+
+
+

Overriding configuration

+

When defining a configuration value that can be defined by a system property or environment variable at runtime, you can +define that via the following:

+
url = "localhost"
+url = ${?POSTGRES_URL}
+
+

The above defines that if there is a system property or environment variable named POSTGRES_URL, then that value will +be used for the url, otherwise, it will default to localhost.

+
+

Data sources

+

To find examples of a task for each type of data source, please check out this page.

+

File

+

Linked here is a list of generic options +that can be included as part of your file data source configuration if required. Links to specific file type +configurations can be found below.

+

CSV

+
+
+
+
csv("customer_transactions", "/data/customer/transaction")
+
+
+
+
csv("customer_transactions", "/data/customer/transaction")
+
+
+
+
csv {
+  customer_transactions {
+    path = "/data/customer/transaction"
+    path = ${?CSV_PATH}
+  }
+}
+
+
+
+
+

Other available configuration for CSV can be found here

+

JSON

+
+
+
+
json("customer_transactions", "/data/customer/transaction")
+
+
+
+
json("customer_transactions", "/data/customer/transaction")
+
+
+
+
json {
+  customer_transactions {
+    path = "/data/customer/transaction"
+    path = ${?JSON_PATH}
+  }
+}
+
+
+
+
+

Other available configuration for JSON can be found here

+

ORC

+
+
+
+
orc("customer_transactions", "/data/customer/transaction")
+
+
+
+
orc("customer_transactions", "/data/customer/transaction")
+
+
+
+
orc {
+  customer_transactions {
+    path = "/data/customer/transaction"
+    path = ${?ORC_PATH}
+  }
+}
+
+
+
+
+

Other available configuration for ORC can be found here

+

Parquet

+
+
+
+
parquet("customer_transactions", "/data/customer/transaction")
+
+
+
+
parquet("customer_transactions", "/data/customer/transaction")
+
+
+
+
parquet {
+  customer_transactions {
+    path = "/data/customer/transaction"
+    path = ${?PARQUET_PATH}
+  }
+}
+
+
+
+
+

Other available configuration for Parquet can be found here

+

Delta (not supported yet)

+
+
+
+
delta("customer_transactions", "/data/customer/transaction")
+
+
+
+
delta("customer_transactions", "/data/customer/transaction")
+
+
+
+
delta {
+  customer_transactions {
+    path = "/data/customer/transaction"
+    path = ${?DELTA_PATH}
+  }
+}
+
+
+
+
+

RMDBS

+

Follows the same configuration used by Spark as +found here.
+Sample can be found below

+
+
+
+
postgres(
+    "customer_postgres",                            #name
+    "jdbc:postgresql://localhost:5432/customer",    #url
+    "postgres",                                     #username
+    "postgres"                                      #password
+)
+
+
+
+
postgres(
+    "customer_postgres",                            #name
+    "jdbc:postgresql://localhost:5432/customer",    #url
+    "postgres",                                     #username
+    "postgres"                                      #password
+)
+
+
+
+
jdbc {
+    customer_postgres {
+        url = "jdbc:postgresql://localhost:5432/customer"
+        url = ${?POSTGRES_URL}
+        user = "postgres"
+        user = ${?POSTGRES_USERNAME}
+        password = "postgres"
+        password = ${?POSTGRES_PASSWORD}
+        driver = "org.postgresql.Driver"
+    }
+}
+
+
+
+
+

Ensure that the user has write permission, so it is able to save the table to the target tables.

+
+SQL Permission Statements +
GRANT INSERT ON <schema>.<table> TO <user>;
+
+
+

Postgres

+

Can see example API or Config definition for Postgres connection above.

+
Permissions
+

Following permissions are required when generating plan and tasks:

+
+SQL Permission Statements +
GRANT SELECT ON information_schema.tables TO < user >;
+GRANT SELECT ON information_schema.columns TO < user >;
+GRANT SELECT ON information_schema.key_column_usage TO < user >;
+GRANT SELECT ON information_schema.table_constraints TO < user >;
+GRANT SELECT ON information_schema.constraint_column_usage TO < user >;
+
+
+

MySQL

+
+
+
+
mysql(
+    "customer_mysql",                       #name
+    "jdbc:mysql://localhost:3306/customer", #url
+    "root",                                 #username
+    "root"                                  #password
+)
+
+
+
+
mysql(
+    "customer_mysql",                       #name
+    "jdbc:mysql://localhost:3306/customer", #url
+    "root",                                 #username
+    "root"                                  #password
+)
+
+
+
+
jdbc {
+    customer_mysql {
+        url = "jdbc:mysql://localhost:3306/customer"
+        user = "root"
+        password = "root"
+        driver = "com.mysql.cj.jdbc.Driver"
+    }
+}
+
+
+
+
+
Permissions
+

Following permissions are required when generating plan and tasks:

+
+SQL Permission Statements +
GRANT SELECT ON information_schema.columns TO < user >;
+GRANT SELECT ON information_schema.statistics TO < user >;
+GRANT SELECT ON information_schema.key_column_usage TO < user >;
+
+
+

Cassandra

+

Follows same configuration as defined by the Spark Cassandra Connector as +found here

+
+
+
+
cassandra(
+    "customer_cassandra",   #name
+    "localhost:9042",       #url
+    "cassandra",            #username
+    "cassandra",            #password
+    Map.of()                #optional additional connection options
+)
+
+
+
+
cassandra(
+    "customer_cassandra",   #name
+    "localhost:9042",       #url
+    "cassandra",            #username
+    "cassandra",            #password
+    Map()                #optional additional connection options
+)
+
+
+
+
org.apache.spark.sql.cassandra {
+    customer_cassandra {
+        spark.cassandra.connection.host = "localhost"
+        spark.cassandra.connection.host = ${?CASSANDRA_HOST}
+        spark.cassandra.connection.port = "9042"
+        spark.cassandra.connection.port = ${?CASSANDRA_PORT}
+        spark.cassandra.auth.username = "cassandra"
+        spark.cassandra.auth.username = ${?CASSANDRA_USERNAME}
+        spark.cassandra.auth.password = "cassandra"
+        spark.cassandra.auth.password = ${?CASSANDRA_PASSWORD}
+    }
+}
+
+
+
+
+
Permissions
+

Ensure that the user has write permission, so it is able to save the table to the target tables.

+
+CQL Permission Statements +
GRANT INSERT ON <schema>.<table> TO <user>;
+
+
+

Following permissions are required when enabling configuration.enableGeneratePlanAndTasks(true) as it will gather +metadata information about tables and columns from the below tables.

+
+CQL Permission Statements +
GRANT SELECT ON system_schema.tables TO <user>;
+GRANT SELECT ON system_schema.columns TO <user>;
+
+
+

Kafka

+

Define your Kafka bootstrap server to connect and send generated data to corresponding topics. Topic gets set at a step +level.
+Further details can be +found here

+
+
+
+
kafka(
+    "customer_kafka",   #name
+    "localhost:9092"    #url
+)
+
+
+
+
kafka(
+    "customer_kafka",   #name
+    "localhost:9092"    #url
+)
+
+
+
+
kafka {
+    customer_kafka {
+        kafka.bootstrap.servers = "localhost:9092"
+        kafka.bootstrap.servers = ${?KAFKA_BOOTSTRAP_SERVERS}
+    }
+}
+
+
+
+
+

When defining your schema for pushing data to Kafka, it follows a specific top level schema.
+An example can be +found here +. You can define the key, value, headers, partition or topic by following the linked schema.

+

JMS

+

Uses JNDI lookup to send messages to JMS queue. Ensure that the messaging system you are using has your queue/topic +registered +via JNDI otherwise a connection cannot be created.

+
+
+
+
solace(
+    "customer_solace",                                      #name
+    "smf://localhost:55554",                                #url
+    "admin",                                                #username
+    "admin",                                                #password
+    "default",                                              #vpn name
+    "/jms/cf/default",                                      #connection factory
+    "com.solacesystems.jndi.SolJNDIInitialContextFactory"   #initial context factory
+)
+
+
+
+
solace(
+    "customer_solace",                                      #name
+    "smf://localhost:55554",                                #url
+    "admin",                                                #username
+    "admin",                                                #password
+    "default",                                              #vpn name
+    "/jms/cf/default",                                      #connection factory
+    "com.solacesystems.jndi.SolJNDIInitialContextFactory"   #initial context factory
+)
+
+
+
+
jms {
+    customer_solace {
+        initialContextFactory = "com.solacesystems.jndi.SolJNDIInitialContextFactory"
+        connectionFactory = "/jms/cf/default"
+        url = "smf://localhost:55555"
+        url = ${?SOLACE_URL}
+        user = "admin"
+        user = ${?SOLACE_USER}
+        password = "admin"
+        password = ${?SOLACE_PASSWORD}
+        vpnName = "default"
+        vpnName = ${?SOLACE_VPN}
+    }
+}
+
+
+
+
+

HTTP

+

Define any username and/or password needed for the HTTP requests.
+The url is defined in the tasks to allow for generated data to be populated in the url.

+
+
+
+
http(
+    "customer_api", #name
+    "admin",        #username
+    "admin"         #password
+)
+
+
+
+
http(
+    "customer_api", #name
+    "admin",        #username
+    "admin"         #password
+)
+
+
+
+
http {
+    customer_api {
+        user = "admin"
+        user = ${?HTTP_USER}
+        password = "admin"
+        password = ${?HTTP_PASSWORD}
+    }
+}
+
+
+
+
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/deployment/deployment/index.html b/setup/deployment/deployment/index.html new file mode 100644 index 00000000..28acc3df --- /dev/null +++ b/setup/deployment/deployment/index.html @@ -0,0 +1,2072 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Deployment - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Deployment

+

Two main ways to deploy and run Data Caterer:

+
    +
  • Docker
    • +
  • Helm
    • +
+

Docker

+

To package up your class along with the Data Caterer base image, you can follow +the Dockerfile that is created for you here.

+

Then you can run the following:

+
./gradlew clean build
+docker build -t <my_image_name>:<my_image_tag> .
+
+

Helm

+

Link to sample helm on GitHub here

+

Update +the configuration +to your own data connections and configuration or own image created from above.

+
git clone git@github.com:pflooky/data-caterer-example.git
+helm install data-caterer ./data-caterer-example/helm/data-caterer
+
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/foreign-key/foreign-key/index.html b/setup/foreign-key/foreign-key/index.html new file mode 100644 index 00000000..21a0bf12 --- /dev/null +++ b/setup/foreign-key/foreign-key/index.html @@ -0,0 +1,2348 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Foreign Keys - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Foreign Keys

+

Multiple data source foreign key example

+

Foreign keys can be defined to represent the relationships between datasets where values are required to match for +particular columns.

+

Single column

+

Define a column in one data source to match against another column.
+Below example shows a postgres data source with two tables, accounts and transactions that have a foreign key +for account_id.

+
+
+
+
var postgresAcc = postgres("my_postgres", "jdbc:...")
+  .table("public.accounts")
+  .schema(
+    field().name("account_id"),
+    field().name("name"),
+    ...
+  );
+var postgresTxn = postgres(postgresAcc)
+  .table("public.transactions")
+  .schema(
+    field().name("account_id"),
+    field().name("full_name"),
+    ...
+  );
+
+plan().addForeignKeyRelationship(
+  postgresAcc, "account_id",
+  List.of(Map.entry(postgresTxn, "account_id"))
+);
+
+
+
+
val postgresAcc = postgres("my_postgres", "jdbc:...")
+  .table("public.accounts")
+  .schema(
+    field.name("account_id"),
+    field.name("name"),
+    ...
+  )
+val postgresTxn = postgres(postgresAcc)
+  .table("public.transactions")
+  .schema(
+    field.name("account_id"),
+    field.name("full_name"),
+    ...
+  )
+
+plan.addForeignKeyRelationship(
+  postgresAcc, "account_id",
+  List(postgresTxn -> "account_id")
+)
+
+
+
+
---
+name: "postgres_data"
+steps:
+  - name: "accounts"
+    type: "postgres"
+    options:
+      dbtable: "account.accounts"
+    schema:
+      fields:
+        - name: "account_id"
+        - name: "name"
+  - name: "transactions"
+    type: "postgres"
+    options:
+      dbtable: "account.transactions"
+    schema:
+      fields:
+        - name: "account_id"
+        - name: "full_name"
+---
+name: "customer_create_plan"
+description: "Create customers in JDBC"
+tasks:
+  - name: "postgres_data"
+    dataSourceName: "my_postgres"
+
+sinkOptions:
+  foreignKeys:
+    "postgres.accounts.account_id":
+      - "postgres.transactions.account_id"
+
+
+
+
+

Multiple columns

+

You may have a scenario where multiple columns need to be aligned. From the same example, we want account_id +and name from accounts to match with account_id and full_name to match in transactions respectively.

+
+
+
+
var postgresAcc = postgres("my_postgres", "jdbc:...")
+  .table("public.accounts")
+  .schema(
+    field().name("account_id"),
+    field().name("name"),
+    ...
+  );
+var postgresTxn = postgres(postgresAcc)
+  .table("public.transactions")
+  .schema(
+    field().name("account_id"),
+    field().name("full_name"),
+    ...
+  );
+
+plan().addForeignKeyRelationship(
+  postgresAcc, List.of("account_id", "name"),
+  List.of(Map.entry(postgresTxn, List.of("account_id", "full_name")))
+);
+
+
+
+
val postgresAcc = postgres("my_postgres", "jdbc:...")
+  .table("public.accounts")
+  .schema(
+    field.name("account_id"),
+    field.name("name"),
+    ...
+  )
+val postgresTxn = postgres(postgresAcc)
+  .table("public.transactions")
+  .schema(
+    field.name("account_id"),
+    field.name("full_name"),
+    ...
+  )
+
+plan.addForeignKeyRelationship(
+  postgresAcc, List("account_id", "name"),
+  List(postgresTxn -> List("account_id", "full_name"))
+)
+
+
+
+
---
+name: "postgres_data"
+steps:
+  - name: "accounts"
+    type: "postgres"
+    options:
+      dbtable: "account.accounts"
+    schema:
+      fields:
+        - name: "account_id"
+        - name: "name"
+  - name: "transactions"
+    type: "postgres"
+    options:
+      dbtable: "account.transactions"
+    schema:
+      fields:
+        - name: "account_id"
+        - name: "full_name"
+---
+name: "customer_create_plan"
+description: "Create customers in JDBC"
+tasks:
+  - name: "postgres_data"
+    dataSourceName: "my_postgres"
+
+sinkOptions:
+  foreignKeys:
+    "my_postgres.accounts.account_id,name":
+      - "my_postgres.transactions.account_id,full_name"
+
+
+
+
+

Nested column

+

Your schema structure can have nested fields which can also be referenced as foreign keys. But to do so, you need to +create a proxy field that gets omitted from the final saved data.

+

In the example below, the nested customer_details.name field inside the json task needs to match with name +from postgres. A new field in the json called _txn_name is used as a temporary column to facilitate the foreign +key definition.

+
+
+
+
var postgresAcc = postgres("my_postgres", "jdbc:...")
+  .table("public.accounts")
+  .schema(
+    field().name("account_id"),
+    field().name("name"),
+    ...
+  );
+var jsonTask = json("my_json", "/tmp/json")
+  .schema(
+    field().name("account_id"),
+    field().name("customer_details")
+      .schema(
+        field().name("name").sql("_txn_name"), #nested field will get value from '_txn_name'
+        ...
+      ),
+    field().name("_txn_name").omit(true)       #value will not be included in output
+  );
+
+plan().addForeignKeyRelationship(
+  postgresAcc, List.of("account_id", "name"),
+  List.of(Map.entry(jsonTask, List.of("account_id", "_txn_name")))
+);
+
+
+
+
val postgresAcc = postgres("my_postgres", "jdbc:...")
+  .table("public.accounts")
+  .schema(
+    field.name("account_id"),
+    field.name("name"),
+    ...
+  )
+var jsonTask = json("my_json", "/tmp/json")
+  .schema(
+    field.name("account_id"),
+    field.name("customer_details")
+      .schema(
+        field.name("name").sql("_txn_name"), #nested field will get value from '_txn_name'
+        ...
+      ), 
+    field.name("_txn_name").omit(true)       #value will not be included in output
+  )
+
+plan.addForeignKeyRelationship(
+  postgresAcc, List("account_id", "name"),
+  List(jsonTask -> List("account_id", "_txn_name"))
+)
+
+
+
+
---
+#postgres task yaml
+name: "postgres_data"
+steps:
+  - name: "accounts"
+    type: "postgres"
+    options:
+      dbtable: "account.accounts"
+    schema:
+      fields:
+        - name: "account_id"
+        - name: "name"
+---
+#json task yaml
+name: "json_data"
+steps:
+  - name: "transactions"
+    type: "json"
+    options:
+      dbtable: "account.transactions"
+    schema:
+      fields:
+        - name: "account_id"
+        - name: "_txn_name"
+          generator:
+            options:
+              omit: true
+        - name: "cusotmer_details"
+          schema:
+            fields:
+              name: "name"
+              generator:
+                type: "sql"
+                options:
+                  sql: "_txn_name"
+
+---
+#plan yaml
+name: "customer_create_plan"
+description: "Create customers in JDBC"
+tasks:
+  - name: "postgres_data"
+    dataSourceName: "my_postgres"
+  - name: "json_data"
+    dataSourceName: "my_json"
+
+sinkOptions:
+  foreignKeys:
+    "my_postgres.accounts.account_id,name":
+      - "my_json.transactions.account_id,_txn_name"
+
+
+
+
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/generator/count/index.html b/setup/generator/count/index.html new file mode 100644 index 00000000..75b7a476 --- /dev/null +++ b/setup/generator/count/index.html @@ -0,0 +1,2250 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Record Count - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Record Count

+

There are options related to controlling the number of records generated that can help in generating the scenarios or data required.

+

Record Count

+

Record count is the simplest as you define the total number of records you require for that particular step. +For example, in the below step, it will generate 1000 records for the CSV file

+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .count(1000);
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .count(1000)
+
+
+
+
name: "csv_file"
+steps:
+  - name: "transactions"
+    type: "csv"
+    options:
+      path: "app/src/test/resources/sample/csv/transactions"
+    count:
+      records: 1000
+
+
+
+
+

Generated Count

+

As like most things in Data Caterer, the count can be generated based on some metadata. +For example, if I wanted to generate between 1000 and 2000 records, I could define that by the below configuration:

+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .count(generator().min(1000).max(2000));
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .count(generator.min(1000).max(2000))
+
+
+
+
name: "csv_file"
+steps:
+  - name: "transactions"
+    type: "csv"
+    options:
+      path: "app/src/test/resources/sample/csv/transactions"
+    count:
+      generator:
+        type: "random"
+        options:
+          min: 1000
+          max: 2000
+
+
+
+
+

Per Column Count

+

When defining a per column count, this allows you to generate records "per set of columns". +This means that for a given set of columns, it will generate a particular amount of records per combination of values for those columns.

+

One example of this would be when generating transactions relating to a customer, a customer may be defined by columns account_id, name. +A number of transactions would be generated per account_id, name.

+

You can also use a combination of the above two methods to generate the number of records per column.

+

Records

+

When defining a base number of records within the perColumn configuration, it translates to creating (count.records * count.recordsPerColumn) records.
+This is a fixed number of records that will be generated each time, with no variation between runs.

+

In the example below, we have count.records = 1000 and count.recordsPerColumn = 2. Which means that 1000 * 2 = 2000 records will be generated +in total.

+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .count(
+    count()
+      .records(1000)
+      .recordsPerColumn(2, "account_id", "name")
+  );
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .count(
+    count
+      .records(1000)
+      .recordsPerColumn(2, "account_id", "name")
+  )
+
+
+
+
name: "csv_file"
+steps:
+  - name: "transactions"
+    type: "csv"
+    options:
+      path: "app/src/test/resources/sample/csv/transactions"
+    count:
+      records: 1000
+      perColumn:
+        records: 2
+        columnNames:
+          - "account_id"
+          - "name"
+
+
+
+
+

Generated

+

You can also define a generator for the count per column. This can be used in scenarios where you want a variable number of records +per set of columns.

+

In the example below, it will generate between (count.records * count.perColumnGenerator.generator.min) = (1000 * 1) = 1000 and +(count.records * count.perColumnGenerator.generator.max) = (1000 * 2) = 2000 records.

+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .count(
+    count()
+      .records(1000)
+      .recordsPerColumnGenerator(generator().min(1).max(2), "account_id", "name")
+  );
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .count(
+    count
+      .records(1000)
+      .recordsPerColumnGenerator(generator.min(1).max(2), "account_id", "name")
+  )
+
+
+
+
name: "csv_file"
+steps:
+  - name: "transactions"
+    type: "csv"
+    options:
+      path: "app/src/test/resources/sample/csv/transactions"
+    count:
+      records: 1000
+      perColumn:
+        columnNames:
+          - "account_id"
+          - "name"
+        generator:
+          type: "random"
+          options:
+            min: 1
+            max: 2
+
+
+
+
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/generator/generator/index.html b/setup/generator/generator/index.html new file mode 100644 index 00000000..44098db6 --- /dev/null +++ b/setup/generator/generator/index.html @@ -0,0 +1,3080 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Data Generator - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Data Generators

+

Data Types

+

Below is a list of all supported data types for generating data:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Data TypeSpark Data TypeOptionsDescription
stringStringTypeminLen, maxLen, expression, enableNull
integerIntegerTypemin, max, stddev, mean
longLongTypemin, max, stddev, mean
shortShortTypemin, max, stddev, mean
decimal(precision, scale)DecimalType(precision, scale)min, max, stddev, mean
doubleDoubleTypemin, max, stddev, mean
floatFloatTypemin, max, stddev, mean
dateDateTypemin, max, enableNull
timestampTimestampTypemin, max, enableNull
booleanBooleanType
binaryBinaryTypeminLen, maxLen, enableNull
byteByteType
arrayArrayTypearrayMinLen, arrayMaxLen, arrayType
_StructTypeImplicitly supported when a schema is defined for a field
+

Options

+

All data types

+

Some options are available to use for all types of data generators. Below is the list along with example and +descriptions:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
OptionDefaultExampleDescription
enableEdgeCasefalseenableEdgeCase: "true"Enable/disable generated data to contain edge cases based on the data type. For example, integer data type has edge cases of (Int.MaxValue, Int.MinValue and 0)
edgeCaseProbability0.0edgeCaseProb: "0.1"Probability of generating a random edge case value if enableEdgeCase is true
isUniquefalseisUnique: "true"Enable/disable generated data to be unique for that column. Errors will be thrown when it is unable to generate unique data
seedseed: "1"Defines the random seed for generating data for that particular column. It will override any seed defined at a global level
sqlsql: "CASE WHEN amount < 10 THEN true ELSE false END"Define any SQL statement for generating that columns value. Computation occurs after all non-SQL fields are generated. This means any columns used in the SQL cannot be based on other SQL generated columns. Data type of generated value from SQL needs to match data type defined for the field
+

String

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
OptionDefaultExampleDescription
minLen1minLen: "2"Ensures that all generated strings have at least length minLen
maxLen10maxLen: "15"Ensures that all generated strings have at most length maxLen
expressionexpression: "#{Name.name}"
expression:"#{Address.city}/#{Demographic.maritalStatus}"		Will generate a string based on the faker expression provided. All possible faker expressions can be found here
Expression has to be in format #{<faker expression name>}
enableNullfalseenableNull: "true"Enable/disable null values being generated
nullProbability0.0nullProb: "0.1"Probability to generate null values if enableNull is true
+

Edge cases: ("", "\n", "\r", "\t", " ", "\u0000", "\ufff", "İyi günler", "Спасибо", "Καλημέρα", "صباح الخير", " +Förlåt", "你好吗", "Nhà vệ sinh ở đâu", "こんにちは", "नमस्ते", "Բարեւ", "Здравейте")

+

Sample

+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field()
+      .name("name")
+      .type(StringType.instance())
+      .expression("#{Name.name}")
+      .enableNull(true)
+      .nullProbability(0.1)
+      .minLength(4)
+      .maxLength(20)
+  );
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field
+      .name("name")
+      .`type`(StringType)
+      .expression("#{Name.name}")
+      .enableNull(true)
+      .nullProbability(0.1)
+      .minLength(4)
+      .maxLength(20)
+  )
+
+
+
+
name: "csv_file"
+steps:
+  - name: "transactions"
+    type: "csv"
+    options:
+      path: "app/src/test/resources/sample/csv/transactions"
+    schema:
+      fields:
+        - name: "name"
+          type: "string"
+          generator:
+            options:
+              expression: "#{Name.name}"
+              enableNull: true
+              nullProb: 0.1
+              minLength: 4
+              maxLength: 20
+
+
+
+
+

Numeric

+

For all the numeric data types, there are 4 options to choose from: min, max and maxValue. +Generally speaking, you only need to define one of min or minValue, similarly with max or maxValue.
+The reason why there are 2 options for each is because of when metadata is automatically gathered, we gather the +statistics of the observed min and max values. Also, it will attempt to gather any restriction on the min or max value +as defined by the data source (i.e. max value as per database type).

+

Integer/Long/Short

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
OptionDefaultExampleDescription
min0min: "2"Ensures that all generated values are greater than or equal to min
max1000max: "25"Ensures that all generated values are less than or equal to max
stddev1.0stddev: "2.0"Standard deviation for normal distributed data
meanmax - minmean: "5.0"Mean for normal distributed data
+

Edge cases Integer: (2147483647, -2147483648, 0)
+Edge cases Long: (9223372036854775807, -9223372036854775808, 0)
+Edge cases Short: (32767, -32768, 0)

+
Sample
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field().name("year").type(IntegerType.instance()).min(2020).max(2023),
+    field().name("customer_id").type(LongType.instance()),
+    field().name("customer_group").type(ShortType.instance())
+  );
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field.name("year").`type`(IntegerType).min(2020).max(2023),
+    field.name("customer_id").`type`(LongType),
+    field.name("customer_group").`type`(ShortType)
+  )
+
+
+
+
name: "csv_file"
+steps:
+  - name: "transactions"
+    ...
+    schema:
+      fields:
+        - name: "year"
+          type: "integer"
+          generator:
+            options:
+              min: 2020
+              max: 2023
+        - name: "customer_id"
+          type: "long"
+        - name: "customer_group"
+          type: "short"
+
+
+
+
+

Decimal

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
OptionDefaultExampleDescription
min0min: "2"Ensures that all generated values are greater than or equal to min
max1000max: "25"Ensures that all generated values are less than or equal to max
stddev1.0stddev: "2.0"Standard deviation for normal distributed data
meanmax - minmean: "5.0"Mean for normal distributed data
numericPrecision10precision: "25"The maximum number of digits
numericScale0scale: "25"The number of digits on the right side of the decimal point (has to be less than or equal to precision)
+

Edge cases Decimal: (9223372036854775807, -9223372036854775808, 0)

+
Sample
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field().name("balance").type(DecimalType.instance()).numericPrecision(10).numericScale(5)
+  );
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field.name("balance").`type`(DecimalType).numericPrecision(10).numericScale(5)
+  )
+
+
+
+
name: "csv_file"
+steps:
+  - name: "transactions"
+    ...
+    schema:
+      fields:
+        - name: "balance"
+          type: "decimal"
+            generator:
+              options:
+                precision: 10
+                scale: 5
+
+
+
+
+

Double/Float

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
OptionDefaultExampleDescription
min0.0min: "2.1"Ensures that all generated values are greater than or equal to min
max1000.0max: "25.9"Ensures that all generated values are less than or equal to max
stddev1.0stddev: "2.0"Standard deviation for normal distributed data
meanmax - minmean: "5.0"Mean for normal distributed data
+

Edge cases Double: (+infinity, 1.7976931348623157e+308, 4.9e-324, 0.0, -0.0, -1.7976931348623157e+308, -infinity, +NaN)
+Edge cases Float: (+infinity, 3.4028235e+38, 1.4e-45, 0.0, -0.0, -3.4028235e+38, -infinity, NaN)

+
Sample
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field().name("amount").type(DoubleType.instance())
+  );
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field.name("amount").`type`(DoubleType)
+  )
+
+
+
+
name: "csv_file"
+steps:
+  - name: "transactions"
+    ...
+    schema:
+      fields:
+        - name: "amount"
+          type: "double"
+
+
+
+
+

Date

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
OptionDefaultExampleDescription
minnow() - 365 daysmin: "2023-01-31"Ensures that all generated values are greater than or equal to min
maxnow()max: "2023-12-31"Ensures that all generated values are less than or equal to max
enableNullfalseenableNull: "true"Enable/disable null values being generated
nullProbability0.0nullProb: "0.1"Probability to generate null values if enableNull is true
+

Edge cases: (0001-01-01, 1582-10-15, 1970-01-01, 9999-12-31) +(reference)

+

Sample

+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field().name("created_date").type(DateType.instance()).min(java.sql.Date.valueOf("2020-01-01"))
+  );
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field.name("created_date").`type`(DateType).min(java.sql.Date.valueOf("2020-01-01"))
+  )
+
+
+
+
name: "csv_file"
+steps:
+  - name: "transactions"
+    ...
+    schema:
+      fields:
+        - name: "created_date"
+          type: "date"
+            generator:
+              options:
+                min: "2020-01-01"
+
+
+
+
+

Timestamp

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
OptionDefaultExampleDescription
minnow() - 365 daysmin: "2023-01-31 23:10:10"Ensures that all generated values are greater than or equal to min
maxnow()max: "2023-12-31 23:10:10"Ensures that all generated values are less than or equal to max
enableNullfalseenableNull: "true"Enable/disable null values being generated
nullProbability0.0nullProb: "0.1"Probability to generate null values if enableNull is true
+

Edge cases: (0001-01-01 00:00:00, 1582-10-15 23:59:59, 1970-01-01 00:00:00, 9999-12-31 23:59:59)

+

Sample

+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field().name("created_time").type(TimestampType.instance()).min(java.sql.Timestamp.valueOf("2020-01-01 00:00:00"))
+  );
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field.name("created_time").`type`(TimestampType).min(java.sql.Timestamp.valueOf("2020-01-01 00:00:00"))
+  )
+
+
+
+
name: "csv_file"
+steps:
+  - name: "transactions"
+    ...
+    schema:
+      fields:
+        - name: "created_time"
+          type: "timestamp"
+            generator:
+              options:
+                min: "2020-01-01 00:00:00"
+
+
+
+
+

Binary

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
OptionDefaultExampleDescription
minLen1minLen: "2"Ensures that all generated array of bytes have at least length minLen
maxLen20maxLen: "15"Ensures that all generated array of bytes have at most length maxLen
enableNullfalseenableNull: "true"Enable/disable null values being generated
nullProbability0.0nullProb: "0.1"Probability to generate null values if enableNull is true
+

Edge cases: ("", "\n", "\r", "\t", " ", "\u0000", "\ufff", -128, 127)

+

Sample

+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field().name("payload").type(BinaryType.instance())
+  );
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field.name("payload").`type`(BinaryType)
+  )
+
+
+
+
name: "csv_file"
+steps:
+  - name: "transactions"
+    ...
+    schema:
+      fields:
+        - name: "payload"
+          type: "binary"
+
+
+
+
+

Array

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
OptionDefaultExampleDescription
arrayMinLen0arrayMinLen: "2"Ensures that all generated arrays have at least length arrayMinLen
arrayMaxLen5arrayMaxLen: "15"Ensures that all generated arrays have at most length arrayMaxLen
arrayTypearrayType: "double"Inner data type of the array. Optional when using Java/Scala API. Allows for nested data types to be defined like struct
enableNullfalseenableNull: "true"Enable/disable null values being generated
nullProbability0.0nullProb: "0.1"Probability to generate null values if enableNull is true
+

Sample

+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field().name("last_5_amounts").type(ArrayType.instance()).arrayType("double")
+  );
+
+
+
+
csv("transactions", "app/src/test/resources/sample/csv/transactions")
+  .schema(
+    field.name("last_5_amounts").`type`(ArrayType).arrayType("double")
+  )
+
+
+
+
name: "csv_file"
+steps:
+  - name: "transactions"
+    ...
+    schema:
+      fields:
+        - name: "last_5_amounts"
+          type: "array<double>"
+
+
+
+
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/generator/report/index.html b/setup/generator/report/index.html new file mode 100644 index 00000000..faf87a35 --- /dev/null +++ b/setup/generator/report/index.html @@ -0,0 +1,2047 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Report - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Report

+

Data Caterer can be configured to produce a report of the data generated to help users understand what was run, how much +data was generated, where it was generated, validation results and any associated metadata.

+

Sample

+

Once run, it will produce a report like this.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/guide/data-source/cassandra/index.html b/setup/guide/data-source/cassandra/index.html new file mode 100644 index 00000000..7dec8f3a --- /dev/null +++ b/setup/guide/data-source/cassandra/index.html @@ -0,0 +1,2637 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Cassandra - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Cassandra

+
+

Info

+

Writing data to Cassandra is a paid feature. Try the free trial here.

+
+

Creating a data generator for Cassandra. You will build a Docker image that will be able to populate data in Cassandra +for the tables you configure.

+

Requirements

+
    +
  • 20 minutes
    • +
  • Git
    • +
  • Gradle
    • +
  • Docker
    • +
  • Cassandra
    • +
+

Get Started

+

First, we will clone the data-caterer-example repo which will already have the base project setup required.

+
git clone git@github.com:pflooky/data-caterer-example.git
+
+

If you already have a Cassandra instance running, you can skip to this step.

+

Cassandra Setup

+

Next, let's make sure you have an instance of Cassandra up and running in your local environment. This will make it +easy for us to iterate and check our changes.

+
cd docker
+docker-compose up -d cassandra
+
+

Permissions

+

Let's make a new user that has the required permissions needed to push data into the Cassandra tables we want.

+
+CQL Permission Statements +
GRANT INSERT ON <schema>.<table> TO data_caterer_user;
+
+
+

Following permissions are required when enabling configuration.enableGeneratePlanAndTasks(true) as it will gather +metadata information about tables and columns from the below tables.

+
+CQL Permission Statements +
GRANT SELECT ON system_schema.tables TO data_caterer_user;
+GRANT SELECT ON system_schema.columns TO data_caterer_user;
+
+
+

Plan Setup

+

Create a new Java or Scala class.

+
    +
  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedCassandraJavaPlan.java
    • +
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedCassandraPlan.scala
    • +
+

Make sure your class extends PlanRun.

+
+
+
+
import com.github.pflooky.datacaterer.java.api.PlanRun;
+
+public class MyAdvancedCassandraJavaPlan extends PlanRun {
+}
+
+
+
+
import com.github.pflooky.datacaterer.api.PlanRun
+
+class MyAdvancedCassandraPlan extends PlanRun {
+}
+
+
+
+
+

This class defines where we need to define all of our configurations for generating data. There are helper variables and +methods defined to make it simple and easy to use.

+

Connection Configuration

+

Within our class, we can start by defining the connection properties to connect to Cassandra.

+
+
+
+
var accountTask = cassandra(
+    "customer_cassandra",   //name
+    "localhost:9042",       //url
+    "cassandra",            //username
+    "cassandra",            //password
+    Map.of()                //optional additional connection options
+)
+
+

Additional options such as SSL configuration, etc can be found here.

+
+
+
val accountTask = cassandra(
+    "customer_cassandra",   //name
+    "localhost:9042",       //url
+    "cassandra",            //username
+    "cassandra",            //password
+    Map()                   //optional additional connection options
+)
+
+

Additional options such as SSL configuration, etc can be found here.

+
+
+
+

Schema

+

Let's create a task for inserting data into the account.accounts and account.account_status_history tables as +defined underdocker/data/cql/customer.cql. This table should already be setup for you if you followed this +step. We can check if the table is setup already via the following command:

+
docker exec host.docker.internal cqlsh -e 'describe account.accounts; describe account.account_status_history;'
+
+

Here we should see some output that looks like the below. This tells us what schema we need to follow when generating +data. We need to define that alongside any metadata that is useful to add constraints on what are possible values the +generated data should contain.

+
CREATE TABLE account.accounts (
+    account_id text PRIMARY KEY,
+    amount double,
+    created_by text,
+    name text,
+    open_time timestamp,
+    status text
+)...
+
+CREATE TABLE account.account_status_history (
+    account_id text,
+    eod_date date,
+    status text,
+    updated_by text,
+    updated_time timestamp,
+    PRIMARY KEY (account_id, eod_date)
+)...
+
+

Trimming the connection details to work with the docker-compose Cassandra, we have a base Cassandra connection to define +the table and schema required. Let's define each field along with their corresponding data type. You will notice that +the text fields do not have a data type defined. This is because the default data type is StringType which +corresponds to text in Cassandra.

+
+
+
+
{
+    var accountTask = cassandra("customer_cassandra", "host.docker.internal:9042")
+            .table("account", "accounts")
+            .schema(
+                    field().name("account_id"),
+                    field().name("amount").type(DoubleType.instance()),
+                    field().name("created_by"),
+                    field().name("name"),
+                    field().name("open_time").type(TimestampType.instance()),
+                    field().name("status")
+            );
+}
+
+
+
+
val accountTask = cassandra("customer_cassandra", "host.docker.internal:9042")
+  .table("account", "accounts")
+  .schema(
+    field.name("account_id"),
+    field.name("amount").`type`(DoubleType),
+    field.name("created_by"),
+    field.name("name"),
+    field.name("open_time").`type`(TimestampType),
+    field.name("status")
+  )
+
+
+
+
+

Field Metadata

+

We could stop here and generate random data for the accounts table. But wouldn't it be more useful if we produced data +that is closer to the structure of the data that would come in production? We can do this by defining various metadata +that add guidelines that the data generator will understand when generating data.

+
account_id
+

account_id follows a particular pattern that where it starts with ACC and has 8 digits after it. +This can be defined via a regex like below. Alongside, we also mention that it is the primary key to prompt ensure that +unique values are generated.

+
+
+
+
field().name("account_id").regex("ACC[0-9]{8}").primaryKey(true),
+
+
+
+
field.name("account_id").regex("ACC[0-9]{8}").primaryKey(true),
+
+
+
+
+
amount
+

amount the numbers shouldn't be too large, so we can define a min and max for the generated numbers to be between +1 and 1000.

+
+
+
+
field().name("amount").type(DoubleType.instance()).min(1).max(1000),
+
+
+
+
field.name("amount").`type`(DoubleType).min(1).max(1000),
+
+
+
+
+
name
+

name is a string that also follows a certain pattern, so we could also define a regex but here we will choose to +leverage the DataFaker library and create an expression to generate real looking name. All possible faker expressions +can be found here

+
+
+
+
field().name("name").expression("#{Name.name}"),
+
+
+
+
field.name("name").expression("#{Name.name}"),
+
+
+
+
+
open_time
+

open_time is a timestamp that we want to have a value greater than a specific date. We can define a min date by using +java.sql.Date like below.

+
+
+
+
field().name("open_time").type(TimestampType.instance()).min(java.sql.Date.valueOf("2022-01-01")),
+
+
+
+
field.name("open_time").`type`(TimestampType).min(java.sql.Date.valueOf("2022-01-01")),
+
+
+
+
+
status
+

status is a field that can only obtain one of four values, open, closed, suspended or pending.

+
+
+
+
field().name("status").oneOf("open", "closed", "suspended", "pending")
+
+
+
+
field.name("status").oneOf("open", "closed", "suspended", "pending")
+
+
+
+
+
created_by
+

created_by is a field that is based on the status field where it follows the logic: if status is open or closed, then +it is created_by eod else created_by event. This can be achieved by defining a SQL expression like below.

+
+
+
+
field().name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+
+
+
+
field.name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+
+
+
+
+

Putting it all the fields together, our class should now look like this.

+
+
+
+
var accountTask = cassandra("customer_cassandra", "host.docker.internal:9042")
+        .table("account", "accounts")
+        .schema(
+                field().name("account_id").regex("ACC[0-9]{8}").primaryKey(true),
+                field().name("amount").type(DoubleType.instance()).min(1).max(1000),
+                field().name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+                field().name("name").expression("#{Name.name}"),
+                field().name("open_time").type(TimestampType.instance()).min(java.sql.Date.valueOf("2022-01-01")),
+                field().name("status").oneOf("open", "closed", "suspended", "pending")
+        );
+
+
+
+
val accountTask = cassandra("customer_cassandra", "host.docker.internal:9042")
+  .table("account", "accounts")
+  .schema(
+    field.name("account_id").primaryKey(true),
+    field.name("amount").`type`(DoubleType).min(1).max(1000),
+    field.name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+    field.name("name").expression("#{Name.name}"),
+    field.name("open_time").`type`(TimestampType).min(java.sql.Date.valueOf("2022-01-01")),
+    field.name("status").oneOf("open", "closed", "suspended", "pending")
+  )
+
+
+
+
+

Additional Configurations

+

At the end of data generation, a report gets generated that summarises the actions it performed. We can control the +output folder of that report via configurations. We will also enable the unique check to ensure any unique fields will +have unique values generated.

+
+
+
+
var config = configuration()
+        .generatedReportsFolderPath("/opt/app/data/report")
+        .enableUniqueCheck(true);
+
+
+
+
val config = configuration
+  .generatedReportsFolderPath("/opt/app/data/report")
+  .enableUniqueCheck(true)
+
+
+
+
+

Execute

+

To tell Data Caterer that we want to run with the configurations along with the accountTask, we have to call execute +. So our full plan run will look like this.

+
+
+
+
public class MyAdvancedCassandraJavaPlan extends PlanRun {
+    {
+        var accountTask = cassandra("customer_cassandra", "host.docker.internal:9042")
+                .table("account", "accounts")
+                .schema(
+                        field().name("account_id").regex("ACC[0-9]{8}").primaryKey(true),
+                        field().name("amount").type(DoubleType.instance()).min(1).max(1000),
+                        field().name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+                        field().name("name").expression("#{Name.name}"),
+                        field().name("open_time").type(TimestampType.instance()).min(java.sql.Date.valueOf("2022-01-01")),
+                        field().name("status").oneOf("open", "closed", "suspended", "pending")
+                );
+
+        var config = configuration()
+                .generatedReportsFolderPath("/opt/app/data/report")
+                .enableUniqueCheck(true);
+
+        execute(config, accountTask);
+    }
+}
+
+
+
+
class MyAdvancedCassandraPlan extends PlanRun {
+  val accountTask = cassandra("customer_cassandra", "host.docker.internal:9042")
+    .table("account", "accounts")
+    .schema(
+      field.name("account_id").primaryKey(true),
+      field.name("amount").`type`(DoubleType).min(1).max(1000),
+      field.name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+      field.name("name").expression("#{Name.name}"),
+      field.name("open_time").`type`(TimestampType).min(java.sql.Date.valueOf("2022-01-01")),
+      field.name("status").oneOf("open", "closed", "suspended", "pending")
+    )
+
+  val config = configuration
+    .generatedReportsFolderPath("/opt/app/data/report")
+    .enableUniqueCheck(true)
+
+  execute(config, accountTask)
+}
+
+
+
+
+

Run

+

Now we can run via the script ./run.sh that is in the top level directory of the data-caterer-example to run the class we just +created.

+
./run.sh
+#input class MyAdvancedCassandraJavaPlan or MyAdvancedCassandraPlan
+#after completing
+docker exec docker-cassandraserver-1 cqlsh -e 'select count(1) from account.accounts;select * from account.accounts limit 10;'
+
+

Your output should look like this.

+
 count
+-------
+  1000
+
+(1 rows)
+
+Warnings :
+Aggregation query used without partition key
+
+
+ account_id  | amount    | created_by         | name                   | open_time                       | status
+-------------+-----------+--------------------+------------------------+---------------------------------+-----------
+ ACC13554145 | 917.00418 | zb CVvbBTTzitjo5fK |          Jan Sanford I | 2023-06-21 21:50:10.463000+0000 | suspended
+ ACC19154140 |  46.99177 |             VH88H9 |       Clyde Bailey PhD | 2023-07-18 11:33:03.675000+0000 |      open
+ ACC50587836 |  774.9872 |         GENANwPm t |           Sang Monahan | 2023-03-21 00:16:53.308000+0000 |    closed
+ ACC67619387 | 452.86706 |       5msTpcBLStTH |         Jewell Gerlach | 2022-10-18 19:13:07.606000+0000 | suspended
+ ACC69889784 |  14.69298 |           WDmOh7NT |          Dale Schulist | 2022-10-25 12:10:52.239000+0000 | suspended
+ ACC41977254 |  51.26492 |          J8jAKzvj2 |           Norma Nienow | 2023-08-19 18:54:39.195000+0000 | suspended
+ ACC40932912 | 349.68067 |   SLcJgKZdLp5ALMyg | Vincenzo Considine III | 2023-05-16 00:22:45.991000+0000 |    closed
+ ACC20642011 | 658.40713 |          clyZRD4fI |  Lannie McLaughlin DDS | 2023-05-11 23:14:30.249000+0000 |      open
+ ACC74962085 | 970.98218 |       ZLETTSnj4NpD |          Ima Jerde DVM | 2023-05-07 10:01:56.218000+0000 |   pending
+ ACC72848439 | 481.64267 |                 cc |        Kyla Deckow DDS | 2023-08-16 13:28:23.362000+0000 | suspended
+
+(10 rows)
+
+

Also check the HTML report, found at docker/sample/report/index.html, that gets generated to get an overview of what +was executed.

+

Sample report

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/guide/data-source/http/index.html b/setup/guide/data-source/http/index.html new file mode 100644 index 00000000..c0a73951 --- /dev/null +++ b/setup/guide/data-source/http/index.html @@ -0,0 +1,2404 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + HTTP - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

HTTP Source

+
+

Info

+

Generating data based on OpenAPI/Swagger document and pushing to HTTP endpoint is a paid feature. Try the free trial here.

+
+

Creating a data generator based on an OpenAPI/Swagger document.

+

Requirements

+
    +
  • 10 minutes
    • +
  • Git
    • +
  • Gradle
    • +
  • Docker
    • +
+

Get Started

+

First, we will clone the data-caterer-example repo which will already have the base project setup required.

+
git clone git@github.com:pflooky/data-caterer-example.git
+
+

HTTP Setup

+

We will be using the http-bin docker image to help simulate a service with HTTP endpoints.

+

Start it via:

+
cd docker
+docker-compose up -d http
+docker ps
+
+

Plan Setup

+

Create a new Java or Scala class.

+
    +
  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedHttpJavaPlanRun.java
    • +
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedHttpPlanRun.scala
    • +
+

Make sure your class extends PlanRun.

+
+
+
+
import com.github.pflooky.datacaterer.java.api.PlanRun;
+...
+
+public class MyAdvancedHttpJavaPlanRun extends PlanRun {
+    {
+        var conf = configuration().enableGeneratePlanAndTasks(true)
+            .generatedReportsFolderPath("/opt/app/data/report");
+    }
+}
+
+
+
+
import com.github.pflooky.datacaterer.api.PlanRun
+...
+
+class MyAdvancedHttpPlanRun extends PlanRun {
+  val conf = configuration.enableGeneratePlanAndTasks(true)
+    .generatedReportsFolderPath("/opt/app/data/report")
+}
+
+
+
+
+

We will enable generate plan and tasks so that we can read from external sources for metadata and save the reports +under a folder we can easily access.

+

Schema

+

We can point the schema of a data source to a OpenAPI/Swagger document or URL. For this example, we will use the OpenAPI +document found under docker/mount/http/petstore.json in the data-caterer-example repo. This is a simplified version of +the original OpenAPI spec that can be found here.

+

We have kept the following endpoints to test out:

+
    +
  • GET /pets - get all pets
    • +
  • POST /pets - create a new pet
    • +
  • GET /pets/{id} - get a pet by id
    • +
  • DELETE /pets/{id} - delete a pet by id
    • +
+
+
+
+
var httpTask = http("my_http")
+        .schema(metadataSource().openApi("/opt/app/mount/http/petstore.json"))
+        .count(count().records(2));
+
+
+
+
val httpTask = http("my_http")
+  .schema(metadataSource.openApi("/opt/app/mount/http/petstore.json"))
+  .count(count.records(2))
+
+
+
+
+

The above defines that the schema will come from an OpenAPI document found on the pathway defined. It will then generate +2 requests per request method and endpoint combination.

+

Run

+

Let's try run and see what happens.

+
cd ..
+./run.sh
+#input class MyAdvancedHttpJavaPlanRun or MyAdvancedHttpPlanRun
+#after completing
+docker logs -f docker-http-1
+
+

It should look something like this.

+
172.21.0.1 [06/Nov/2023:01:06:53 +0000] GET /anything/pets?tags%3DeXQxFUHVja+EYm%26limit%3D33895 HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:06:53 +0000] GET /anything/pets?tags%3DSXaFvAqwYGF%26tags%3DjdNRFONA%26limit%3D40975 HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:06:56 +0000] POST /anything/pets HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:06:56 +0000] POST /anything/pets HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:07:00 +0000] GET /anything/pets/kbH8D7rDuq HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:07:00 +0000] GET /anything/pets/REsa0tnu7dvekGDvxR HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:07:03 +0000] DELETE /anything/pets/EqrOr1dHFfKUjWb HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:07:03 +0000] DELETE /anything/pets/7WG7JHPaNxP HTTP/1.1 200 Host: host.docker.internal}
+
+

Looks like we have some data now. But we can do better and add some enhancements to it.

+

Foreign keys

+

The four different requests that get sent could have the same id passed across to each of them if we define a foreign +key relationship. This will make it more realistic to a real life scenario as pets get created and queried by a +particular id value. We note that the id value is first used when a pet is created in the body of the POST request. +Then it gets used as a path parameter in the DELETE and GET requests.

+

To link them all together, we must follow a particular pattern when referring to request body, query parameter or path +parameter columns.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
HTTP TypeColumn PrefixExample
Request BodybodyContentbodyContent.id
Path ParameterpathParampathParamid
Query ParameterqueryParamqueryParamid
+

Also note, that when creating a foreign field definition for a HTTP data source, to refer to a specific endpoint and +method, we have to follow the pattern of {http method}{http path}. For example, POST/pets. Let's apply this +knowledge to link all the id values together.

+
+
+
+
var myPlan = plan().addForeignKeyRelationship(
+        foreignField("my_http", "POST/pets", "bodyContent.id"),
+        foreignField("my_http", "GET/pets/{id}", "pathParamid"),
+        foreignField("my_http", "DELETE/pets/{id}", "pathParamid")
+);
+
+execute(myPlan, conf, httpTask);
+
+
+
+
val myPlan = plan.addForeignKeyRelationship(
+  foreignField("my_http", "POST/pets", "bodyContent.id"),
+  foreignField("my_http", "GET/pets/{id}", "pathParamid"),
+  foreignField("my_http", "DELETE/pets/{id}", "pathParamid")
+)
+
+execute(myPlan, conf, httpTask)
+
+
+
+
+

Let's test it out by running it again

+
./run.sh
+#input class MyAdvancedHttpJavaPlanRun or MyAdvancedHttpPlanRun
+docker logs -f docker-http-1
+
+
172.21.0.1 [06/Nov/2023:01:33:59 +0000] GET /anything/pets?limit%3D45971 HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:34:00 +0000] GET /anything/pets?limit%3D62015 HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:34:04 +0000] POST /anything/pets HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:34:05 +0000] POST /anything/pets HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:34:09 +0000] DELETE /anything/pets/5e HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:34:09 +0000] DELETE /anything/pets/IHPm2 HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:34:14 +0000] GET /anything/pets/IHPm2 HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:34:14 +0000] GET /anything/pets/5e HTTP/1.1 200 Host: host.docker.internal}
+
+

Now we have the same id values being produced across the POST, DELETE and GET requests! What if we knew that the id +values should follow a particular pattern?

+

Custom metadata

+

So given that we have defined a foreign key where the root of the foreign key values is from the POST request, we can +update the metadata of the id column for the POST request and it will proliferate to the other endpoints as well. +Given the id column is a nested column as noted in the foreign key, we can alter its metadata via the following:

+
+
+
+
var httpTask = http("my_http")
+        .schema(metadataSource().openApi("/opt/app/mount/http/petstore.json"))
+        .schema(field().name("bodyContent").schema(field().name("id").regex("ID[0-9]{8}")))
+        .count(count().records(2));
+
+
+
+
val httpTask = http("my_http")
+  .schema(metadataSource.openApi("/opt/app/mount/http/petstore.json"))
+  .schema(field.name("bodyContent").schema(field.name("id").regex("ID[0-9]{8}")))
+  .count(count.records(2))
+
+
+
+
+

We first get the column bodyContent, then get the nested schema and get the column id and add metadata stating that +id should follow the patter ID[0-9]{8}.

+

Let's try run again, and hopefully we should see some proper ID values.

+
./run.sh
+#input class MyAdvancedHttpJavaPlanRun or MyAdvancedHttpPlanRun
+docker logs -f docker-http-1
+
+
172.21.0.1 [06/Nov/2023:01:45:45 +0000] GET /anything/pets?tags%3D10fWnNoDz%26limit%3D66804 HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:45:46 +0000] GET /anything/pets?tags%3DhyO6mI8LZUUpS HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:45:50 +0000] POST /anything/pets HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:45:51 +0000] POST /anything/pets HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:45:52 +0000] DELETE /anything/pets/ID55185420 HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:45:52 +0000] DELETE /anything/pets/ID20618951 HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:45:57 +0000] GET /anything/pets/ID55185420 HTTP/1.1 200 Host: host.docker.internal}
+172.21.0.1 [06/Nov/2023:01:45:57 +0000] GET /anything/pets/ID20618951 HTTP/1.1 200 Host: host.docker.internal}
+
+

Great! Now we have replicated a production-like flow of HTTP requests.

+

Ordering

+

If you wanted to change the ordering of the requests, you can alter the order from within the OpenAPI/Swagger document.

+

Rows per second

+

By default, Data Caterer will push requests per method and endpoint at a rate of around 5 requests per second. If you +want to alter this value, you can do so via the below configuration.

+
+
+
+
var httpTask = http("my_http")
+        ...
+        .count(count().records(2));
+
+
+
+
val httpTask = http("my_http")
+  ...
+  .count(count.records(2))
+
+
+
+
+

Check out the full example under AdvancedHttpPlanRun in the example repo.

+ + + + + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/guide/data-source/kafka/index.html b/setup/guide/data-source/kafka/index.html new file mode 100644 index 00000000..3bf274a4 --- /dev/null +++ b/setup/guide/data-source/kafka/index.html @@ -0,0 +1,2499 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Kafka - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Kafka

+
+

Info

+

Writing data to Kafka is a paid feature. Try the free trial here.

+
+

Creating a data generator for Kafka. You will build a Docker image that will be able to populate data in kafka +for the topics you configure.

+

Requirements

+
    +
  • 20 minutes
    • +
  • Git
    • +
  • Gradle
    • +
  • Docker
    • +
  • Kafka
    • +
+

Get Started

+

First, we will clone the data-caterer-example repo which will already have the base project setup required.

+
git clone git@github.com:pflooky/data-caterer-example.git
+
+

If you already have a Kafka instance running, you can skip to this step.

+

Kafka Setup

+

Next, let's make sure you have an instance of Kafka up and running in your local environment. This will make it +easy for us to iterate and check our changes.

+
cd docker
+docker-compose up -d kafka
+
+

Plan Setup

+

Create a new Java or Scala class.

+
    +
  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedKafkaJavaPlan.java
    • +
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedKafkaPlan.scala
    • +
+

Make sure your class extends PlanRun.

+
+
+
+
import com.github.pflooky.datacaterer.java.api.PlanRun;
+
+public class MyAdvancedKafkaJavaPlan extends PlanRun {
+}
+
+
+
+
import com.github.pflooky.datacaterer.api.PlanRun
+
+class MyAdvancedKafkaPlan extends PlanRun {
+}
+
+
+
+
+

This class defines where we need to define all of our configurations for generating data. There are helper variables and +methods defined to make it simple and easy to use.

+

Connection Configuration

+

Within our class, we can start by defining the connection properties to connect to Kafka.

+
+
+
+
var accountTask = kafka(
+    "my_kafka",       //name
+    "localhost:9092", //url
+    Map.of()          //optional additional connection options
+);
+
+

Additional options can be found here.

+
+
+
val accountTask = kafka(
+    "my_kafka",       //name
+    "localhost:9092", //url
+    Map()             //optional additional connection options
+)
+
+

Additional options can be found here.

+
+
+
+

Schema

+

Let's create a task for inserting data into the account-topic that is already +defined underdocker/data/kafka/setup_kafka.sh. This topic should already be setup for you if you followed this +step. We can check if the topic is set up already via the following command:

+
docker exec docker-kafkaserver-1 kafka-topics --bootstrap-server localhost:9092 --list
+
+

Trimming the connection details to work with the docker-compose Kafka, we have a base Kafka connection to define +the topic we will publish to. Let's define each field along with their corresponding data type. You will notice that +the text fields do not have a data type defined. This is because the default data type is StringType.

+
+
+
+
{
+    var kafkaTask = kafka("my_kafka", "kafkaserver:29092")
+            .topic("account-topic")
+            .schema(
+                    field().name("key").sql("content.account_id"),
+                    field().name("value").sql("TO_JSON(content)"),
+                    //field().name("partition").type(IntegerType.instance()),  can define partition here
+                    field().name("headers")
+                            .type(ArrayType.instance())
+                            .sql(
+                                    "ARRAY(" +
+                                            "NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8'))," +
+                                            "NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))" +
+                                            ")"
+                            ),
+                    field().name("content")
+                            .schema(
+                                    field().name("account_id").regex("ACC[0-9]{8}"),
+                                    field().name("year").type(IntegerType.instance()),
+                                    field().name("amount").type(DoubleType.instance()),
+                                    field().name("details")
+                                            .schema(
+                                                    field().name("name").expression("#{Name.name}"),
+                                                    field().name("first_txn_date").type(DateType.instance()).sql("ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)"),
+                                                    field().name("updated_by")
+                                                            .schema(
+                                                                    field().name("user"),
+                                                                    field().name("time").type(TimestampType.instance())
+                                                            )
+                                            ),
+                                    field().name("transactions").type(ArrayType.instance())
+                                            .schema(
+                                                    field().name("txn_date").type(DateType.instance()).min(Date.valueOf("2021-01-01")).max("2021-12-31"),
+                                                    field().name("amount").type(DoubleType.instance())
+                                            )
+                            ),
+                    field().name("tmp_year").sql("content.year").omit(true),
+                    field().name("tmp_name").sql("content.details.name").omit(true)
+            )
+}
+
+
+
+
val kafkaTask = kafka("my_kafka", "kafkaserver:29092")
+  .topic("account-topic")
+  .schema(
+    field.name("key").sql("content.account_id"),
+    field.name("value").sql("TO_JSON(content)"),
+    //field.name("partition").type(IntegerType),  can define partition here
+    field.name("headers")
+      .`type`(ArrayType)
+      .sql(
+        """ARRAY(
+          |  NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8')),
+          |  NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))
+          |)""".stripMargin
+      ),
+    field.name("content")
+      .schema(
+        field.name("account_id").regex("ACC[0-9]{8}"),
+        field.name("year").`type`(IntegerType).min(2021).max(2023),
+        field.name("amount").`type`(DoubleType),
+        field.name("details")
+          .schema(
+            field.name("name").expression("#{Name.name}"),
+            field.name("first_txn_date").`type`(DateType).sql("ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)"),
+            field.name("updated_by")
+              .schema(
+                field.name("user"),
+                field.name("time").`type`(TimestampType),
+              ),
+          ),
+        field.name("transactions").`type`(ArrayType)
+          .schema(
+            field.name("txn_date").`type`(DateType).min(Date.valueOf("2021-01-01")).max("2021-12-31"),
+            field.name("amount").`type`(DoubleType),
+          )
+      ),
+    field.name("tmp_year").sql("content.year").omit(true),
+    field.name("tmp_name").sql("content.details.name").omit(true)
+  )
+
+
+
+
+

Fields

+

The schema defined for Kafka has a format that needs to be followed as noted above. Specifically, the required fields are: +- value

+

Whilst, the other fields are optional: +- key +- partition +- headers

+
headers
+

headers follows a particular pattern that where it is of type array<struct<key: string,value: binary>>. To be able +to generate data for this data type, we need to use an SQL expression like the one below. You will notice that in the +value part, it refers to content.account_id where content is another field defined at the top level of the schema. +This allows you to reference other values that have already been generated.

+
+
+
+
field().name("headers")
+        .type(ArrayType.instance())
+        .sql(
+                "ARRAY(" +
+                        "NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8'))," +
+                        "NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))" +
+                        ")"
+        )
+
+
+
+
field.name("headers")
+  .`type`(ArrayType)
+  .sql(
+    """ARRAY(
+      |  NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8')),
+      |  NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))
+      |)""".stripMargin
+  )
+
+
+
+
+
transactions
+

transactions is an array that contains an inner structure of txn_date and amount. The size of the array generated +can be controlled via arrayMinLength and arrayMaxLength.

+
+
+
+
field().name("transactions").type(ArrayType.instance())
+        .schema(
+                field().name("txn_date").type(DateType.instance()).min(Date.valueOf("2021-01-01")).max("2021-12-31"),
+                field().name("amount").type(DoubleType.instance())
+        )
+
+
+
+
field.name("transactions").`type`(ArrayType)
+  .schema(
+    field.name("txn_date").`type`(DateType).min(Date.valueOf("2021-01-01")).max("2021-12-31"),
+    field.name("amount").`type`(DoubleType),
+  )
+
+
+
+
+
details
+

details is another example of a nested schema structure where it also has a nested structure itself in updated_by. +One thing to note here is the first_txn_date field has a reference to the content.transactions array where it will +sort the array by txn_date and get the first element.

+
+
+
+
field().name("details")
+        .schema(
+                field().name("name").expression("#{Name.name}"),
+                field().name("first_txn_date").type(DateType.instance()).sql("ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)"),
+                field().name("updated_by")
+                        .schema(
+                                field().name("user"),
+                                field().name("time").type(TimestampType.instance())
+                        )
+        )
+
+
+
+
field.name("details")
+  .schema(
+    field.name("name").expression("#{Name.name}"),
+    field.name("first_txn_date").`type`(DateType).sql("ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)"),
+    field.name("updated_by")
+      .schema(
+        field.name("user"),
+        field.name("time").`type`(TimestampType),
+      ),
+  )
+
+
+
+
+

Additional Configurations

+

At the end of data generation, a report gets generated that summarises the actions it performed. We can control the +output folder of that report via configurations.

+
+
+
+
var config = configuration()
+        .generatedReportsFolderPath("/opt/app/data/report");
+
+
+
+
val config = configuration
+  .generatedReportsFolderPath("/opt/app/data/report")
+
+
+
+
+

Execute

+

To tell Data Caterer that we want to run with the configurations along with the kafkaTask, we have to call execute +.

+

Run

+

Now we can run via the script ./run.sh that is in the top level directory of the data-caterer-example to run the class we just +created.

+
./run.sh
+#input class AdvancedKafkaJavaPlanRun or AdvancedKafkaPlanRun
+#after completing
+docker exec docker-kafkaserver-1 kafka-console-consumer --bootstrap-server localhost:9092 --topic account-topic --from-beginning
+
+

Your output should look like this.

+
{"account_id":"ACC56292178","year":2022,"amount":18338.627721151555,"details":{"name":"Isaias Reilly","first_txn_date":"2021-01-22","updated_by":{"user":"FgYXbKDWdhHVc3","time":"2022-12-30T13:49:07.309Z"}},"transactions":[{"txn_date":"2021-01-22","amount":30556.52125487579},{"txn_date":"2021-10-29","amount":39372.302259554635},{"txn_date":"2021-10-29","amount":61887.31389495968}]}
+{"account_id":"ACC37729457","year":2022,"amount":96885.31758764731,"details":{"name":"Randell Witting","first_txn_date":"2021-06-30","updated_by":{"user":"HCKYEBHN8AJ3TB","time":"2022-12-02T02:05:01.144Z"}},"transactions":[{"txn_date":"2021-06-30","amount":98042.09647765031},{"txn_date":"2021-10-06","amount":41191.43564742036},{"txn_date":"2021-11-16","amount":78852.08184809204},{"txn_date":"2021-10-09","amount":13747.157653571106}]}
+{"account_id":"ACC23127317","year":2023,"amount":81164.49304198896,"details":{"name":"Jed Wisozk","updated_by":{"user":"9MBFZZ","time":"2023-07-12T05:56:52.397Z"}},"transactions":[]}
+
+

Also check the HTML report, found at docker/sample/report/index.html, that gets generated to get an overview of what +was executed.

+

Sample report

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/guide/data-source/marquez-metadata-source/index.html b/setup/guide/data-source/marquez-metadata-source/index.html new file mode 100644 index 00000000..37f2eaec --- /dev/null +++ b/setup/guide/data-source/marquez-metadata-source/index.html @@ -0,0 +1,2375 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Marquez Metadata Source - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Metadata Source

+
+

Info

+

Generating data based on an external metadata source is a paid feature. Try the free trial here.

+
+

Creating a data generator for Postgres tables and CSV file based on metadata stored in Marquez ( +follows OpenLineage API).

+

Requirements

+
    +
  • 10 minutes
    • +
  • Git
    • +
  • Gradle
    • +
  • Docker
    • +
+

Get Started

+

First, we will clone the data-caterer-example repo which will already have the base project setup required.

+
git clone git@github.com:pflooky/data-caterer-example.git
+
+

Marquez Setup

+

You can follow the README found here to help with setting up Marquez in +your local environment. This comes with an instance of Postgres which we will also be using as a data store for +generated data.

+

The command that was run for this example to help with setup of dummy data was ./docker/up.sh -a 5001 -m 5002 --seed.

+

Check that the following url shows some data like below once you click on food_delivery +from the ns drop down in the top right corner.

+

Marquez dashboard

+

Postgres Setup

+

Since we will also be using the Marquez Postgres instance as a data source, we will set up a separate database to store +the generated data in via:

+
docker exec marquez-db psql -Upostgres -c 'CREATE DATABASE food_delivery'
+
+

Plan Setup

+

Create a new Java or Scala class.

+
    +
  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedMetadataSourceJavaPlanRun.java
    • +
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedMetadataSourcePlanRun.scala
    • +
+

Make sure your class extends PlanRun.

+
+
+
+
import com.github.pflooky.datacaterer.java.api.PlanRun;
+...
+
+public class MyAdvancedMetadataSourceJavaPlanRun extends PlanRun {
+    {
+        var conf = configuration().enableGeneratePlanAndTasks(true)
+            .generatedReportsFolderPath("/opt/app/data/report");
+    }
+}
+
+
+
+
import com.github.pflooky.datacaterer.api.PlanRun
+...
+
+class MyAdvancedMetadataSourcePlanRun extends PlanRun {
+  val conf = configuration.enableGeneratePlanAndTasks(true)
+    .generatedReportsFolderPath("/opt/app/data/report")
+}
+
+
+
+
+

We will enable generate plan and tasks so that we can read from external sources for metadata and save the reports +under a folder we can easily access.

+

Schema

+

We can point the schema of a data source to our Marquez instance. For the Postgres data source, we will point to a +namespace, which in Marquez or OpenLineage, represents a set of datasets. For the CSV data source, we will point to +a specific namespace and dataset.

+
Single Schema
+
+
+
+
var csvTask = csv("my_csv", "/tmp/data/csv", Map.of("saveMode", "overwrite", "header", "true"))
+        .schema(metadataSource().marquez("http://localhost:5001", "food_delivery", "public.delivery_7_days"))
+        .count(count().records(10));
+
+
+
+
val csvTask = csv("my_csv", "/tmp/data/csv", Map("saveMode" -> "overwrite", "header" -> "true"))
+  .schema(metadataSource.marquez("http://localhost:5001", "food_delivery", "public.delivery_7_days"))
+  .count(count.records(10))
+
+
+
+
+

The above defines that the schema will come from Marquez, which is a type of metadata source that contains information +about schemas. Specifically, it points to the food_delivery namespace and public.categories dataset to retrieve the +schema information from.

+
Multiple Schemas
+
+
+
+
var postgresTask = postgres("my_postgres", "jdbc:postgresql://host.docker.internal:5432/food_delivery", "postgres", "password", Map.of())
+    .schema(metadataSource().marquez("http://host.docker.internal:5001", "food_delivery"))
+    .count(count().records(10));
+
+
+
+
val postgresTask = postgres("my_postgres", "jdbc:postgresql://host.docker.internal:5432/food_delivery", "postgres", "password")
+  .schema(metadataSource.marquez("http://host.docker.internal:5001", "food_delivery"))
+  .count(count.records(10))
+
+
+
+
+

We now have pointed this Postgres instance to produce multiple schemas that are defined under the food_delivery +namespace. Also note that we are using database food_delivery in Postgres to push our generated data to, and we have +set the number of records per sub data source (in this case, per table) to be 10.

+

Run

+

Let's try run and see what happens.

+
cd ..
+./run.sh
+#input class MyAdvancedMetadataSourceJavaPlanRun or MyAdvancedMetadataSourcePlanRun
+#after completing
+docker exec marquez-db psql -Upostgres -d food_delivery -c 'SELECT * FROM public.delivery_7_days'
+
+

It should look something like this.

+
 order_id |     order_placed_on     |   order_dispatched_on   |   order_delivered_on    |         customer_email         |                     customer_address                     | menu_id | restaurant_id |                        restaurant_address
+   | menu_item_id | category_id | discount_id | city_id | driver_id
+----------+-------------------------+-------------------------+-------------------------+--------------------------------+----------------------------------------------------------+---------+---------------+---------------------------------------------------------------
+---+--------------+-------------+-------------+---------+-----------
+    38736 | 2023-02-05 06:05:23.755 | 2023-09-08 04:29:10.878 | 2023-09-03 23:58:34.285 | april.skiles@hotmail.com       | 5018 Lang Dam, Gaylordfurt, MO 35172                     |   59841 |         30971 | Suite 439 51366 Bartoletti Plains, West Lashawndamouth, CA 242
+42 |        55697 |       36370 |       21574 |   88022 |     16569
+     4376 | 2022-12-19 14:39:53.442 | 2023-08-30 07:40:06.948 | 2023-03-15 20:38:26.11  | adelina.balistreri@hotmail.com | Apt. 340 9146 Novella Motorway, East Troyhaven, UT 34773 |   66195 |         42765 | Suite 670 8956 Rob Fork, Rennershire, CA 04524
+   |        26516 |       81335 |       87615 |   27433 |     45649
+    11083 | 2022-10-30 12:46:38.692 | 2023-06-02 13:05:52.493 | 2022-11-27 18:38:07.873 | johnny.gleason@gmail.com       | Apt. 385 99701 Lemke Place, New Irvin, RI 73305          |   66427 |         44438 | 1309 Danny Cape, Weimanntown, AL 15865
+   |        41686 |       36508 |       34498 |   24191 |     92405
+    58759 | 2023-07-26 14:32:30.883 | 2022-12-25 11:04:08.561 | 2023-04-21 17:43:05.86  | isabelle.ohara@hotmail.com     | 2225 Evie Lane, South Ardella, SD 90805                  |   27106 |         25287 | Suite 678 3731 Dovie Park, Port Luigi, ID 08250
+   |        94205 |       66207 |       81051 |   52553 |     27483
+
+

You can also try query some other tables. Let's also check what is in the CSV file.

+
$ head docker/sample/csv/part-0000*
+menu_item_id,category_id,discount_id,city_id,driver_id,order_id,order_placed_on,order_dispatched_on,order_delivered_on,customer_email,customer_address,menu_id,restaurant_id,restaurant_address
+72248,37098,80135,45888,5036,11090,2023-09-20T05:33:08.036+08:00,2023-05-16T23:10:57.119+08:00,2023-05-01T22:02:23.272+08:00,demetrice.rohan@hotmail.com,"406 Harmony Rue, Wisozkburgh, MD 12282",33762,9042,"Apt. 751 0796 Ellan Flats, Lake Chetville, WI 81957"
+41644,40029,48565,83373,89919,58359,2023-04-18T06:28:26.194+08:00,2022-10-15T18:17:48.998+08:00,2023-02-06T17:02:04.104+08:00,joannie.okuneva@yahoo.com,"Suite 889 022 Susan Lane, Zemlakport, OR 56996",27467,6216,"Suite 016 286 Derick Grove, Dooleytown, NY 14664"
+49299,53699,79675,40821,61764,72234,2023-07-16T21:33:48.739+08:00,2023-02-14T21:23:10.265+08:00,2023-09-18T02:08:51.433+08:00,ina.heller@yahoo.com,"Suite 600 86844 Heller Island, New Celestinestad, DE 42622",48002,12462,"5418 Okuneva Mountain, East Blairchester, MN 04060"
+83197,86141,11085,29944,81164,65382,2023-01-20T06:08:25.981+08:00,2023-01-11T13:24:32.968+08:00,2023-09-09T02:30:16.890+08:00,lakisha.bashirian@yahoo.com,"Suite 938 534 Theodore Lock, Port Caitlynland, LA 67308",69109,47727,"4464 Stewart Tunnel, Marguritemouth, AR 56791"
+
+

Looks like we have some data now. But we can do better and add some enhancements to it.

+

What if we wanted the same records in Postgres public.delivery_7_days to also show up in the CSV file? That's where we +can use a foreign key definition.

+

Foreign Key

+

We can take a look at the report (under docker/sample/report/index.html) to see what we need to do to create the +foreign key. From the overview, you should see under Tasks there is a my_postgres task which has +food_delivery_public.delivery_7_days as a step. Click on the link for food_delivery_public.delivery_7_days and it +will take us to a page where we can find out about the columns used in this table. Click on the Fields button on the +far right to see.

+

We can copy all of a subset of fields that we want matched across the CSV file and Postgres. For this example, we will +take all the fields.

+
+
+
+
var myPlan = plan().addForeignKeyRelationship(
+        postgresTask, List.of("key", "tmp_year", "tmp_name", "value"),
+        List.of(Map.entry(csvTask, List.of("account_number", "year", "name", "payload")))
+);
+
+var conf = ...
+
+execute(myPlan, conf, postgresTask, csvTask);
+
+
+
+
val foreignCols = List("order_id", "order_placed_on", "order_dispatched_on", "order_delivered_on", "customer_email",
+  "customer_address", "menu_id", "restaurant_id", "restaurant_address", "menu_item_id", "category_id", "discount_id",
+  "city_id", "driver_id")
+
+val myPlan = plan.addForeignKeyRelationships(
+  csvTask, foreignCols,
+  List(foreignField(postgresTask, "food_delivery_public.delivery_7_days", foreignCols))
+)
+
+val conf = ...
+
+execute(myPlan, conf, postgresTask, csvTask)
+
+
+
+
+

Notice how we have defined the csvTask and foreignCols as the main foreign key but for postgresTask, we had to +define it as a foreignField. This is because postgresTask has multiple tables within it, and we only want to define +our foreign key with respect to the public.delivery_7_days table. We use the step name (can be seen from the report) +to specify the table to target.

+

To test this out, we will truncate the public.delivery_7_days table in Postgres first, and then try run again.

+
docker exec marquez-db psql -Upostgres -d food_delivery -c 'TRUNCATE public.delivery_7_days'
+./run.sh
+#input class MyAdvancedMetadataSourceJavaPlanRun or MyAdvancedMetadataSourcePlanRun
+docker exec marquez-db psql -Upostgres -d food_delivery -c 'SELECT * FROM public.delivery_7_days'
+
+
 order_id |     order_placed_on     |   order_dispatched_on   |   order_delivered_on    |        customer_email        |
+       customer_address                     | menu_id | restaurant_id |                   restaurant_address                   | menu
+_item_id | category_id | discount_id | city_id | driver_id
+----------+-------------------------+-------------------------+-------------------------+------------------------------+-------------
+--------------------------------------------+---------+---------------+--------------------------------------------------------+-----
+---------+-------------+-------------+---------+-----------
+    53333 | 2022-10-15 08:40:23.394 | 2023-01-23 09:42:48.397 | 2023-08-12 08:50:52.397 | normand.aufderhar@gmail.com  | Apt. 036 449
+27 Wilderman Forge, Marvinchester, CT 15952 |   40412 |         70130 | Suite 146 98176 Schaden Village, Grahammouth, SD 12354 |
+   90141 |       44210 |       83966 |   78614 |     77449
+
+

Let's grab the first email from the Postgres table and check whether the same record exists in the CSV file.

+
$ cat docker/sample/csv/part-0000* | grep normand.aufderhar
+90141,44210,83966,78614,77449,53333,2022-10-15T08:40:23.394+08:00,2023-01-23T09:42:48.397+08:00,2023-08-12T08:50:52.397+08:00,normand.aufderhar@gmail.com,"Apt. 036 44927 Wilderman Forge, Marvinchester, CT 15952",40412,70130,"Suite 146 98176 Schaden Village, Grahammouth, SD 12354"
+
+

Great! Now we have the ability to get schema information from an external source, add our own foreign keys and generate +data.

+

Check out the full example under AdvancedMetadataSourcePlanRun in the example repo.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/guide/data-source/open-metadata-source/index.html b/setup/guide/data-source/open-metadata-source/index.html new file mode 100644 index 00000000..dfa454bf --- /dev/null +++ b/setup/guide/data-source/open-metadata-source/index.html @@ -0,0 +1,2453 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + OpenMetadata Source - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

OpenMetadata Source

+
+

Info

+

Generating data based on an external metadata source is a paid feature. Try the free trial here.

+
+

Creating a data generator for a JSON file based on metadata stored +in OpenMetadata.

+

Requirements

+
    +
  • 10 minutes
    • +
  • Git
    • +
  • Gradle
    • +
  • Docker
    • +
+

Get Started

+

First, we will clone the data-caterer-example repo which will already have the base project setup required.

+
git clone git@github.com:pflooky/data-caterer-example.git
+
+

OpenMetadata Setup

+

You can follow the local docker setup found +here to help with setting up +OpenMetadata in your local environment.

+

If that page becomes outdated or the link doesn't work, below are the commands I used to run it:

+
mkdir openmetadata-docker && cd openmetadata-docker
+curl -sL https://github.com/open-metadata/OpenMetadata/releases/download/1.2.0-release/docker-compose.yml > docker-compose.yml
+docker compose -f docker-compose.yml up --detach
+
+

Check that the following url works and login with admin:admin. Then you should see some data +like below:

+

OpenMetadata dashboard

+

Plan Setup

+

Create a new Java or Scala class.

+
    +
  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedOpenMetadataSourceJavaPlanRun.java
    • +
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedOpenMetadataSourcePlanRun.scala
    • +
+

Make sure your class extends PlanRun.

+
+
+
+
import com.github.pflooky.datacaterer.java.api.PlanRun;
+...
+
+public class MyAdvancedOpenMetadataSourceJavaPlanRun extends PlanRun {
+    {
+        var conf = configuration().enableGeneratePlanAndTasks(true)
+            .generatedReportsFolderPath("/opt/app/data/report");
+    }
+}
+
+
+
+
import com.github.pflooky.datacaterer.api.PlanRun
+...
+
+class MyAdvancedOpenMetadataSourcePlanRun extends PlanRun {
+  val conf = configuration.enableGeneratePlanAndTasks(true)
+    .generatedReportsFolderPath("/opt/app/data/report")
+}
+
+
+
+
+

We will enable generate plan and tasks so that we can read from external sources for metadata and save the reports +under a folder we can easily access.

+

Schema

+

We can point the schema of a data source to our OpenMetadata instance. We will use a JSON data source so that we can +show how nested data types are handled and how we could customise it.

+
Single Schema
+
+
+
+
import com.github.pflooky.datacaterer.api.model.Constants;
+...
+
+var jsonTask = json("my_json", "/opt/app/data/json", Map.of("saveMode", "overwrite"))
+        .schema(metadataSource().openMetadataJava(
+            "http://localhost:8585/api",                                                              //url
+            Constants.OPEN_METADATA_AUTH_TYPE_OPEN_METADATA(),                                        //auth type
+            Map.of(                                                                                   //additional options (including auth options)
+                Constants.OPEN_METADATA_JWT_TOKEN(), "abc123",                                        //get from settings/bots/ingestion-bot
+                Constants.OPEN_METADATA_TABLE_FQN(), "sample_data.ecommerce_db.shopify.raw_customer"  //table fully qualified name
+            )
+        ))
+        .count(count().records(10));
+
+
+
+
import com.github.pflooky.datacaterer.api.model.Constants.{OPEN_METADATA_AUTH_TYPE_OPEN_METADATA, OPEN_METADATA_JWT_TOKEN, OPEN_METADATA_TABLE_FQN, SAVE_MODE}
+...
+
+val jsonTask = json("my_json", "/opt/app/data/json", Map("saveMode" -> "overwrite"))
+  .schema(metadataSource.openMetadata(
+    "http://localhost:8585/api",                                                  //url
+    OPEN_METADATA_AUTH_TYPE_OPEN_METADATA,                                        //auth type
+    Map(                                                                          //additional options (including auth options)
+      OPEN_METADATA_JWT_TOKEN -> "abc123",                                        //get from settings/bots/ingestion-bot
+      OPEN_METADATA_TABLE_FQN -> "sample_data.ecommerce_db.shopify.raw_customer"  //table fully qualified name
+    )
+  ))
+  .count(count.records(10))
+
+
+
+
+

The above defines that the schema will come from OpenMetadata, which is a type of metadata source that contains +information about schemas. Specifically, it points to the sample_data.ecommerce_db.shopify.raw_customer table. You +can check out the schema here to +see what it looks like.

+

Run

+

Let's try run and see what happens.

+
cd ..
+./run.sh
+#input class MyAdvancedOpenMetadataSourceJavaPlanRun or MyAdvancedOpenMetadataSourcePlanRun
+#after completing
+cat docker/sample/json/part-00000-*
+
+

It should look something like this.

+
{
+  "comments": "Mh6jqpD5e4M",
+  "creditcard": "6771839575926717",
+  "membership": "Za3wCQUl9E  EJj712",
+  "orders": [
+    {
+      "product_id": "Aa6NG0hxfHVq",
+      "price": 16139,
+      "onsale": false,
+      "tax": 58134,
+      "weight": 40734,
+      "others": 45813,
+      "vendor": "Kh"
+    },
+    {
+      "product_id": "zbHBY ",
+      "price": 17903,
+      "onsale": false,
+      "tax": 39526,
+      "weight": 9346,
+      "others": 52035,
+      "vendor": "jbkbnXAa"
+    },
+    {
+      "product_id": "5qs3gakppd7Nw5",
+      "price": 48731,
+      "onsale": true,
+      "tax": 81105,
+      "weight": 2004,
+      "others": 20465,
+      "vendor": "nozCDMSXRPH Ev"
+    },
+    {
+      "product_id": "CA6h17ANRwvb",
+      "price": 62102,
+      "onsale": true,
+      "tax": 96601,
+      "weight": 78849,
+      "others": 79453,
+      "vendor": " ihVXEJz7E2EFS"
+    }
+  ],
+  "platform": "GLt9",
+  "preference": {
+    "key": "nmPmsPjg C",
+    "value": true
+  },
+  "shipping_address": [
+    {
+      "name": "Loren Bechtelar",
+      "street_address": "Suite 526 293 Rohan Road, Wunschshire, NE 25532",
+      "city": "South Norrisland",
+      "postcode": "56863"
+    }
+  ],
+  "shipping_date": "2022-11-03",
+  "transaction_date": "2023-02-01",
+  "customer": {
+    "username": "lance.murphy",
+    "name": "Zane Brakus DVM",
+    "sex": "7HcAaPiO",
+    "address": "594 Loida Haven, Gilland, MA 26071",
+    "mail": "Un3fhbvK2rEbenIYdnq",
+    "birthdate": "2023-01-31"
+  }
+}
+
+

Looks like we have some data now. But we can do better and add some enhancements to it.

+

Custom metadata

+

We can see from the data generated, that it isn't quite what we want. The metadata is not sufficient for us to produce +production-like data yet. Let's try to add some enhancements to it.

+

Let's make the platform field a choice field that can only be a set of certain values and the nested +field customer.sex is also from a predefined set of values.

+
+
+
+
var jsonTask = json("my_json", "/opt/app/data/json", Map.of("saveMode", "overwrite"))
+            .schema(
+                metadata...
+            ))
+            .schema(
+                field().name("platform").oneOf("website", "mobile"),
+                field().name("customer").schema(field().name("sex").oneOf("M", "F", "O"))
+            )
+            .count(count().records(10));
+
+
+
+
val jsonTask = json("my_json", "/opt/app/data/json", Map("saveMode" -> "overwrite"))
+  .schema(
+    metadata...
+  ))
+  .schema(
+    field.name("platform").oneOf("website", "mobile"),
+    field.name("customer").schema(field.name("sex").oneOf("M", "F", "O"))
+  )
+  .count(count.records(10))
+
+
+
+
+

Let's test it out by running it again

+
./run.sh
+#input class MyAdvancedMetadataSourceJavaPlanRun or MyAdvancedMetadataSourcePlanRun
+cat docker/sample/json/part-00000-*
+
+
{
+  "comments": "vqbPUm",
+  "creditcard": "6304867705548636",
+  "membership": "GZ1xOnpZSUOKN",
+  "orders": [
+    {
+      "product_id": "rgOokDAv",
+      "price": 77367,
+      "onsale": false,
+      "tax": 61742,
+      "weight": 87855,
+      "others": 26857,
+      "vendor": "04XHR64ImMr9T"
+    }
+  ],
+  "platform": "mobile",
+  "preference": {
+    "key": "IB5vNdWka",
+    "value": true
+  },
+  "shipping_address": [
+    {
+      "name": "Isiah Bins",
+      "street_address": "36512 Ross Spurs, Hillhaven, IA 18760",
+      "city": "Averymouth",
+      "postcode": "75818"
+    },
+    {
+      "name": "Scott Prohaska",
+      "street_address": "26573 Haley Ports, Dariusland, MS 90642",
+      "city": "Ashantimouth",
+      "postcode": "31792"
+    },
+    {
+      "name": "Rudolf Stamm",
+      "street_address": "Suite 878 0516 Danica Path, New Christiaport, ID 10525",
+      "city": "Doreathaport",
+      "postcode": "62497"
+    }
+  ],
+  "shipping_date": "2023-08-24",
+  "transaction_date": "2023-02-01",
+  "customer": {
+    "username": "jolie.cremin",
+    "name": "Fay Klein",
+    "sex": "O",
+    "address": "Apt. 174 5084 Volkman Creek, Hillborough, PA 61959",
+    "mail": "BiTmzb7",
+    "birthdate": "2023-04-07"
+  }
+}
+
+

Great! Now we have the ability to get schema information from an external source, add our own metadata and generate +data.

+

Data validation

+

Another aspect of OpenMetadata that can be leveraged is the definition of data quality rules. These rules can be +incorporated into your Data Caterer job as well by enabling data validations via enableGenerateValidations in +configuration.

+
+
+
+
var conf = configuration().enableGeneratePlanAndTasks(true)
+    .enableGenerateValidations(true)
+    .generatedReportsFolderPath("/opt/app/data/report");
+
+execute(conf, jsonTask);
+
+
+
+
val conf = configuration.enableGeneratePlanAndTasks(true)
+  .enableGenerateValidations(true)
+  .generatedReportsFolderPath("/opt/app/data/report")
+
+execute(conf, jsonTask)
+
+
+
+
+

Check out the full example under AdvancedOpenMetadataSourcePlanRun in the example repo.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/guide/data-source/solace/index.html b/setup/guide/data-source/solace/index.html new file mode 100644 index 00000000..89e6d0ae --- /dev/null +++ b/setup/guide/data-source/solace/index.html @@ -0,0 +1,2497 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Solace - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Solace

+
+

Info

+

Writing data to Solace is a paid feature. Try the free trial here.

+
+

Creating a data generator for Solace. You will build a Docker image that will be able to populate data in Solace +for the queues/topics you configure.

+

Requirements

+
    +
  • 20 minutes
    • +
  • Git
    • +
  • Gradle
    • +
  • Docker
    • +
  • Solace
    • +
+

Get Started

+

First, we will clone the data-caterer-example repo which will already have the base project setup required.

+
git clone git@github.com:pflooky/data-caterer-example.git
+
+

If you already have a Solace instance running, you can skip to this step.

+

Solace Setup

+

Next, let's make sure you have an instance of Solace up and running in your local environment. This will make it +easy for us to iterate and check our changes.

+
cd docker
+docker-compose up -d solace
+
+

Open up localhost:8080 and login with admin:admin and check there is the default VPN like +below. Notice there is 2 queues/topics created. If you do not see 2 created, try to run the script found under +docker/data/solace/setup_solace.sh and change the host to localhost.

+

Solace dashboard

+

Plan Setup

+

Create a new Java or Scala class.

+
    +
  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedSolaceJavaPlan.java
    • +
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedSolacePlan.scala
    • +
+

Make sure your class extends PlanRun.

+
+
+
+
import com.github.pflooky.datacaterer.java.api.PlanRun;
+
+public class MyAdvancedSolaceJavaPlan extends PlanRun {
+}
+
+
+
+
import com.github.pflooky.datacaterer.api.PlanRun
+
+class MyAdvancedSolacePlan extends PlanRun {
+}
+
+
+
+
+

This class defines where we need to define all of our configurations for generating data. There are helper variables and +methods defined to make it simple and easy to use.

+

Connection Configuration

+

Within our class, we can start by defining the connection properties to connect to Solace.

+
+
+
+
var accountTask = solace(
+    "my_solace",                        //name
+    "smf://host.docker.internal:55554", //url
+    Map.of()                            //optional additional connection options
+);
+
+

Additional connection options can be found here.

+
+
+
val accountTask = solace(
+    "my_solace",                        //name
+    "smf://host.docker.internal:55554", //url
+    Map()                               //optional additional connection options
+)
+
+

Additional connection options can be found here.

+
+
+
+

Schema

+

Let's create a task for inserting data into the rest_test_queue or rest_test_topic that is already created for us +from this step.

+

Trimming the connection details to work with the docker-compose Solace, we have a base Solace connection to define +the JNDI destination we will publish to. Let's define each field along with their corresponding data type. You will +notice +that the text fields do not have a data type defined. This is because the default data type is StringType.

+
+
+
+
{
+    var solaceTask = solace("my_solace", "smf://host.docker.internal:55554")
+            .destination("/JNDI/Q/rest_test_queue")
+            .schema(
+                    field().name("value").sql("TO_JSON(content)"),
+                    //field().name("partition").type(IntegerType.instance()),   //can define message JMS priority here
+                    field().name("headers")                                     //set message properties via headers field
+                            .type(HeaderType.getType())
+                            .sql(
+                                    "ARRAY(" +
+                                            "NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8'))," +
+                                            "NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))" +
+                                            ")"
+                            ),
+                    field().name("content")
+                            .schema(
+                                    field().name("account_id").regex("ACC[0-9]{8}"),
+                                    field().name("year").type(IntegerType.instance()).min(2021).max(2023),
+                                    field().name("amount").type(DoubleType.instance()),
+                                    field().name("details")
+                                            .schema(
+                                                    field().name("name").expression("#{Name.name}"),
+                                                    field().name("first_txn_date").type(DateType.instance()).sql("ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)"),
+                                                    field().name("updated_by")
+                                                            .schema(
+                                                                    field().name("user"),
+                                                                    field().name("time").type(TimestampType.instance())
+                                                            )
+                                            ),
+                                    field().name("transactions").type(ArrayType.instance())
+                                            .schema(
+                                                    field().name("txn_date").type(DateType.instance()).min(Date.valueOf("2021-01-01")).max("2021-12-31"),
+                                                    field().name("amount").type(DoubleType.instance())
+                                            )
+                            )
+            )
+            .count(count().records(10));
+}
+
+
+
+
val solaceTask = solace("my_solace", "smf://host.docker.internal:55554")
+  .destination("/JNDI/Q/rest_test_queue")
+  .schema(
+    field.name("value").sql("TO_JSON(content)"),
+    //field.name("partition").`type`(IntegerType),  //can define message JMS priority here
+    field.name("headers")                           //set message properties via headers field
+      .`type`(HeaderType.getType)
+      .sql(
+        """ARRAY(
+          |  NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8')),
+          |  NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))
+          |)""".stripMargin
+      ),
+    field.name("content")
+      .schema(
+        field.name("account_id").regex("ACC[0-9]{8}"),
+        field.name("year").`type`(IntegerType).min(2021).max(2023),
+        field.name("amount").`type`(DoubleType),
+        field.name("details")
+          .schema(
+            field.name("name").expression("#{Name.name}"),
+            field.name("first_txn_date").`type`(DateType).sql("ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)"),
+            field.name("updated_by")
+              .schema(
+                field.name("user"),
+                field.name("time").`type`(TimestampType),
+              ),
+          ),
+        field.name("transactions").`type`(ArrayType)
+          .schema(
+            field.name("txn_date").`type`(DateType).min(Date.valueOf("2021-01-01")).max("2021-12-31"),
+            field.name("amount").`type`(DoubleType),
+          )
+      ),
+  ).count(count.records(10))
+
+
+
+
+

Fields

+

The schema defined for Solace has a format that needs to be followed as noted above. Specifically, the required fields +are:

+
    +
  • value
    • +
+

Whilst, the other fields are optional:

+
    +
  • partition - refers to JMS priority of the message
    • +
  • headers - refers to JMS message properties
    • +
+
headers
+

headers follows a particular pattern that where it is of type HeaderType.getType which behind the scenes, translates +toarray<struct<key: string,value: binary>>. To be able to generate data for this data type, we need to use an SQL +expression like the one below. You will notice that in thevalue part, it refers to content.account_id where +content is another field defined at the top level of the schema. This allows you to reference other values that have +already been generated.

+
+
+
+
field().name("headers")
+        .type(HeaderType.getType())
+        .sql(
+                "ARRAY(" +
+                        "NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8'))," +
+                        "NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))" +
+                        ")"
+        )
+
+
+
+
field.name("headers")
+  .`type`(HeaderType.getType)
+  .sql(
+    """ARRAY(
+      |  NAMED_STRUCT('key', 'account-id', 'value', TO_BINARY(content.account_id, 'utf-8')),
+      |  NAMED_STRUCT('key', 'updated', 'value', TO_BINARY(content.details.updated_by.time, 'utf-8'))
+      |)""".stripMargin
+  )
+
+
+
+
+
transactions
+

transactions is an array that contains an inner structure of txn_date and amount. The size of the array generated +can be controlled via arrayMinLength and arrayMaxLength.

+
+
+
+
field().name("transactions").type(ArrayType.instance())
+        .schema(
+                field().name("txn_date").type(DateType.instance()).min(Date.valueOf("2021-01-01")).max("2021-12-31"),
+                field().name("amount").type(DoubleType.instance())
+        )
+
+
+
+
field.name("transactions").`type`(ArrayType)
+  .schema(
+    field.name("txn_date").`type`(DateType).min(Date.valueOf("2021-01-01")).max("2021-12-31"),
+    field.name("amount").`type`(DoubleType),
+  )
+
+
+
+
+
details
+

details is another example of a nested schema structure where it also has a nested structure itself in updated_by. +One thing to note here is the first_txn_date field has a reference to the content.transactions array where it will +sort the array by txn_date and get the first element.

+
+
+
+
field().name("details")
+        .schema(
+                field().name("name").expression("#{Name.name}"),
+                field().name("first_txn_date").type(DateType.instance()).sql("ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)"),
+                field().name("updated_by")
+                        .schema(
+                                field().name("user"),
+                                field().name("time").type(TimestampType.instance())
+                        )
+        )
+
+
+
+
field.name("details")
+  .schema(
+    field.name("name").expression("#{Name.name}"),
+    field.name("first_txn_date").`type`(DateType).sql("ELEMENT_AT(SORT_ARRAY(content.transactions.txn_date), 1)"),
+    field.name("updated_by")
+      .schema(
+        field.name("user"),
+        field.name("time").`type`(TimestampType),
+      ),
+  )
+
+
+
+
+

Additional Configurations

+

At the end of data generation, a report gets generated that summarises the actions it performed. We can control the +output folder of that report via configurations.

+
+
+
+
var config = configuration()
+        .generatedReportsFolderPath("/opt/app/data/report");
+
+
+
+
val config = configuration
+  .generatedReportsFolderPath("/opt/app/data/report")
+
+
+
+
+

Execute

+

To tell Data Caterer that we want to run with the configurations along with the kafkaTask, we have to call execute.

+

Run

+

Now we can run via the script ./run.sh that is in the top level directory of the data-caterer-example to run the +class we just created.

+
./run.sh
+#input class AdvancedSolaceJavaPlanRun or AdvancedSolacePlanRun
+#after completing, check http://localhost:8080 from browser
+
+

Your output should look like this.

+

Solace messages queued

+

Unfortunately, there is no easy way to see the message content. You can check the message content from your application +or service that consumes these messages.

+

Also check the HTML report, found at docker/sample/report/index.html, that gets generated to get an overview of what +was executed. Or view the sample report found here.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/guide/index.html b/setup/guide/index.html new file mode 100644 index 00000000..dbdc1fb4 --- /dev/null +++ b/setup/guide/index.html @@ -0,0 +1,2296 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Guides - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Guides

+

Below are a list of guides you can follow to create your data generation for your use case.

+

For any of the paid tier guides, you can use the trial version fo the app to try it out. Details on how to get +the trial can be found here.

+

Scenarios

+
+

Free tier scenarios

+
+ +
+
+
+

Paid tier scenarios

+
+ +
+
+

Data Sources

+
+

Free tier data sources

+
+ +
+
+
+

Paid tier data sources

+
+
    +
  • Cassandra - Cassandra tables
    • +
  • Kafka - Kafka topics
    • +
  • Solace - Solace messages
    • +
  • Marquez - Generate data based on metadata in Marquez
    • +
  • OpenMetadata - Generate data based on metadata in OpenMetadata
    • +
  • HTTP - HTTP requests
    • +
  • MySql - (Soon to document) JDBC MySql tables
    • +
+
+
+

YAML Files

+

Base Concept

+

The execution of the data generator is based on the concept of plans and tasks. A plan represent the set of tasks that +need to be executed, +along with other information that spans across tasks, such as foreign keys between data sources.
+A task represent the component(s) of a data source and its associated metadata so that it understands what the data +should look like +and how many steps (sub data sources) there are (i.e. tables in a database, topics in Kafka). Tasks can define one or +more steps.

+

Plan

+

Foreign Keys

+

Define foreign keys across data sources in your plan to ensure generated data can match
+Link to associated task 1
+Link to associated task 2

+

Task

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Data Source TypeData SourceSample TaskNotes
DatabasePostgresSample
DatabaseMySQLSample
DatabaseCassandraSample
FileCSVSample
FileJSONSampleContains nested schemas and use of SQL for generated values
FileParquetSamplePartition by year column
KafkaKafkaSampleSpecific base schema to be used, define headers, key, value, etc.
JMSSolaceSampleJSON formatted message
HTTPPUTSampleJSON formatted PUT body
+

Configuration

+

Basic configuration

+

Docker-compose

+

To see how it runs against different data sources, you can run using docker-compose and set DATA_SOURCE like below

+
./gradlew build
+cd docker
+DATA_SOURCE=postgres docker-compose up -d datacaterer
+
+

Can set it to one of the following:

+
    +
  • postgres
    • +
  • mysql
    • +
  • cassandra
    • +
  • solace
    • +
  • kafka
    • +
  • http
    • +
+ + + + + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/guide/scenario/auto-generate-connection/index.html b/setup/guide/scenario/auto-generate-connection/index.html new file mode 100644 index 00000000..60b4055d --- /dev/null +++ b/setup/guide/scenario/auto-generate-connection/index.html @@ -0,0 +1,2309 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Auto Generate From Data Connection - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Auto Generate From Data Connection

+
+

Info

+

Auto data generation from data connection is a paid feature. Try the free trial here.

+
+

Creating a data generator based on only a data connection to Postgres.

+

Requirements

+
    +
  • 5 minutes
    • +
  • Git
    • +
  • Gradle
    • +
  • Docker
    • +
+

Get Started

+

First, we will clone the data-caterer-example repo which will already have the base project setup required.

+
git clone git@github.com:pflooky/data-caterer-example.git
+
+

Plan Setup

+

Create a new Java or Scala class.

+
    +
  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedAutomatedJavaPlanRun.java
    • +
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedAutomatedPlanRun.scala
    • +
+

Make sure your class extends PlanRun.

+
+
+
+
import com.github.pflooky.datacaterer.java.api.PlanRun;
+...
+
+public class MyAdvancedAutomatedJavaPlanRun extends PlanRun {
+    {
+        var autoRun = configuration()
+                .postgres("my_postgres", "jdbc:postgresql://host.docker.internal:5432/customer")  (1)
+                .enableGeneratePlanAndTasks(true)                                                 (2)
+                .generatedPlanAndTaskFolderPath("/opt/app/data/generated")                        (3)
+                .enableUniqueCheck(true)                                                          (4)
+                .generatedReportsFolderPath("/opt/app/data/report");
+
+        execute(autoRun);
+    }
+}
+
+
+
+
import com.github.pflooky.datacaterer.api.PlanRun
+...
+
+class MyAdvancedAutomatedPlanRun extends PlanRun {
+
+  val autoRun = configuration
+    .postgres("my_postgres", "jdbc:postgresql://host.docker.internal:5432/customer")  (1)
+    .enableGeneratePlanAndTasks(true)                                                 (2)
+    .generatedPlanAndTaskFolderPath("/opt/app/data/generated")                        (3)
+    .enableUniqueCheck(true)                                                          (4)
+    .generatedReportsFolderPath("/opt/app/data/report")
+
+  execute(configuration = autoRun)
+}
+
+
+
+
+

In the above code, we note the following:

+
    +
  1. Data source configuration to a Postgres data source called my_postgres
    2. +
  2. We have enabled the flag enableGeneratePlanAndTasks which tells Data Caterer to go to my_postgres and generate + data for all the tables found under the database customer (which is defined in the connection string).
    3. +
  3. The config generatedPlanAndTaskFolderPath defines where the metadata that is gathered from my_postgres should be + saved at so that we could re-use it later.
    4. +
  4. enableUniqueCheck is set to true to ensure that generated data is unique based on primary key or foreign key + definitions.
    5. +
+
+

Note

+

Unique check will only ensure generated data is unique. Any existing data in your data source is not taken into +account, so generated data may fail to insert depending on the data source restrictions

+
+

Postgres Setup

+

If you don't have your own Postgres up and running, you can set up and run an instance configured in the docker +folder via.

+
cd docker
+docker-compose up -d postgres
+docker exec docker-postgresserver-1 psql -Upostgres -d customer -c '\dt+ account.*'
+
+

This will create the tables found under docker/data/sql/postgres/customer.sql. You can change this file to contain +your own tables. We can see there are 4 tables created for us, accounts, balances, transactions and mapping.

+

Run

+

Let's try run.

+
cd ..
+./run.sh
+#input class MyAdvancedAutomatedJavaPlanRun or MyAdvancedAutomatedPlanRun
+#after completing
+docker exec docker-postgresserver-1 psql -Upostgres -d customer -c 'select * from account.accounts limit 1;'
+
+

It should look something like this.

+
   id   | account_number  | account_status | created_by | created_by_fixed_length | customer_id_int | customer_id_smallint | customer_id_bigint |   customer_id_decimal    | customer_id_real | customer_id_double | open_date  |     open_timestamp      | last_opened_time |                                                           payload_bytes
+--------+-----------------+----------------+------------+-------------------------+-----------------+----------------------+--------------------+--------------------------+------------------+--------------------+------------+-------------------------+------------------+------------------------------------------------------------------------------------------------------------------------------------
+ 100414 | 5uROOVOUyQUbubN | h3H            | SfA0eZJcTm | CuRw                    |              13 |                   42 |               6041 | 76987.745612542900000000 |         91866.78 |  66400.37433202339 | 2023-03-05 | 2023-08-14 11:33:11.343 | 23:58:01.736     | \x604d315d4547616e6a233050415373317274736f5e682d516132524f3d23233c37463463322f342d34376d597e665d6b3d395b4238284028622b7d6d2b4f5042
+(1 row)
+
+

The data that gets inserted will follow the foreign keys that are defined within Postgres and also ensure the insertion +order is correct.

+

Also check the HTML report that gets generated under docker/sample/report/index.html. You can see a summary of what +was generated along with other metadata.

+

You can now look to play around with other tables or data sources and auto generate for them.

+

Additional Topics

+

Learn From Existing Data

+

If you have any existing data within your data source, Data Caterer will gather metadata about the existing data to +help guide it when generating new data. There are configurations that can help tune the metadata analysis found +here.

+

Filter Out Schema/Tables

+

As part of your connection definition, you can define any schemas and/or tables your don't want to generate data for. In +the example below, it will not generate any data for any tables under the history and audit schemas. Also, any +table with the name balances or transactions in any schema will also not have data generated.

+
+
+
+
var autoRun = configuration()
+        .postgres(
+              "my_postgres", 
+              "jdbc:postgresql://host.docker.internal:5432/customer",
+              Map.of(
+                  "filterOutSchema", "history, audit",
+                  "filterOutTable", "balances, transactions")
+              )
+        )
+
+
+
+
val autoRun = configuration
+  .postgres(
+    "my_postgres",
+    "jdbc:postgresql://host.docker.internal:5432/customer",
+    Map(
+      "filterOutSchema" -> "history, audit",
+      "filterOutTable" -> "balances, transactions")
+    )
+  )
+
+
+
+
+

Define record count

+

You can control the record count per sub data source via numRecordsPerStep.

+
+
+
+
var autoRun = configuration()
+      ...
+      .numRecordsPerStep(100)
+
+execute(autoRun)
+
+
+
+
val autoRun = configuration
+  ...
+  .numRecordsPerStep(100)
+
+execute(configuration = autoRun)
+
+
+
+
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/guide/scenario/batch-and-event/index.html b/setup/guide/scenario/batch-and-event/index.html new file mode 100644 index 00000000..d49e0f02 --- /dev/null +++ b/setup/guide/scenario/batch-and-event/index.html @@ -0,0 +1,2315 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Generate Batch and Event Data - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Generate Batch and Event Data

+
+

Info

+

Generating event data is a paid feature. Try the free trial here.

+
+

Creating a data generator for Kafka topic with matching records in a CSV file.

+

Requirements

+
    +
  • 5 minutes
    • +
  • Git
    • +
  • Gradle
    • +
  • Docker
    • +
+

Get Started

+

First, we will clone the data-caterer-example repo which will already have the base project setup required.

+
git clone git@github.com:pflooky/data-caterer-example.git
+
+

Kafka Setup

+

If you don't have your own Kafka up and running, you can set up and run an instance configured in the docker +folder via.

+
cd docker
+docker-compose up -d kafka
+docker exec docker-kafkaserver-1 kafka-topics --bootstrap-server localhost:9092 --list
+
+

Let's create a task for inserting data into the account-topic that is already defined +underdocker/data/kafka/setup_kafka.sh.

+

Plan Setup

+

Create a new Java or Scala class.

+
    +
  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedBatchEventJavaPlanRun.java
    • +
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedBatchEventPlanRun.scala
    • +
+

Make sure your class extends PlanRun.

+
+
+
+
import com.github.pflooky.datacaterer.java.api.PlanRun;
+...
+
+public class MyAdvancedBatchEventJavaPlanRun extends PlanRun {
+    {
+        var kafkaTask = new AdvancedKafkaJavaPlanRun().getKafkaTask();
+    }
+}
+
+
+
+
import com.github.pflooky.datacaterer.api.PlanRun
+...
+
+class MyAdvancedBatchEventPlanRun extends PlanRun {
+  val kafkaTask = new AdvancedKafkaPlanRun().kafkaTask
+}
+
+
+
+
+

We will borrow the Kafka task that is already defined under the class AdvancedKafkaPlanRun +or AdvancedKafkaJavaPlanRun. You can go through the Kafka guide here for more details.

+

Schema

+

Let us set up the corresponding schema for the CSV file where we want to match the values that are generated for the +Kafka messages.

+
+
+
+
var kafkaTask = new AdvancedKafkaJavaPlanRun().getKafkaTask();
+
+var csvTask = csv("my_csv", "/opt/app/data/csv/account")
+        .schema(
+                field().name("account_number"),
+                field().name("year"),
+                field().name("name"),
+                field().name("payload")
+        );
+
+
+
+
val kafkaTask = new AdvancedKafkaPlanRun().kafkaTask
+
+val csvTask = csv("my_csv", "/opt/app/data/csv/account")
+  .schema(
+    field.name("account_number"),
+    field.name("year"),
+    field.name("name"),
+    field.name("payload")
+)
+
+
+
+
+

This is a simple schema where we want to use the values and metadata that is already defined in the kafkaTask to +determine what the data will look like for the CSV file. Even if we defined some metadata here, it would be overridden +when we define our foreign key relationships.

+

Foreign Keys

+

From the above CSV schema, we see note the following against the Kafka schema:

+
    +
  • account_number in CSV needs to match with the account_id in Kafka
      +
    • We see that account_id is referred to in the key column as field.name("key").sql("content.account_id")
      • +
    +
    • +
  • year needs to match with content.year in Kafka, which is a nested field
      +
    • We can only do foreign key relationships with top level fields, not nested fields. So we define a new column + called tmp_year which will not appear in the final output for the Kafka messages but is used as an intermediate + step field.name("tmp_year").sql("content.year").omit(true)
      • +
    +
    • +
  • name needs to match with content.details.name in Kafka, also a nested field
      +
    • Using the same logic as above, we define a temporary column called tmp_name which will take the value of the + nested field but will be omitted field.name("tmp_name").sql("content.details.name").omit(true)
      • +
    +
    • +
  • payload represents the whole JSON message sent to Kafka, which matches to value column
    • +
+

Our foreign keys are therefore defined like below. Order is important when defining the list of columns. The index needs +to match with the corresponding column in the other data source.

+
+
+
+
var myPlan = plan().addForeignKeyRelationship(
+        kafkaTask, List.of("key", "tmp_year", "tmp_name", "value"),
+        List.of(Map.entry(csvTask, List.of("account_number", "year", "name", "payload")))
+);
+
+var conf = configuration()
+      .generatedReportsFolderPath("/opt/app/data/report");
+
+execute(myPlan, conf, kafkaTask, csvTask);
+
+
+
+
val myPlan = plan.addForeignKeyRelationship(
+    kafkaTask, List("key", "tmp_year", "tmp_name", "value"),
+    List(csvTask -> List("account_number", "year", "name", "payload"))
+)
+
+val conf = configuration.generatedReportsFolderPath("/opt/app/data/report")
+
+execute(myPlan, conf, kafkaTask, csvTask)
+
+
+
+
+

Run

+

Let's try run.

+
cd ..
+./run.sh
+#input class MyAdvancedBatchEventJavaPlanRun or MyAdvancedBatchEventPlanRun
+#after completing
+docker exec docker-kafkaserver-1 kafka-console-consumer --bootstrap-server localhost:9092 --topic account-topic --from-beginning
+
+

It should look something like this.

+
{"account_id":"ACC03093143","year":2023,"amount":87990.37196728592,"details":{"name":"Nadine Heidenreich Jr.","first_txn_date":"2021-11-09","updated_by":{"user":"YfEyJCe8ohrl0j IfyT","time":"2022-09-26T20:47:53.404Z"}},"transactions":[{"txn_date":"2021-11-09","amount":97073.7914706189}]}
+{"account_id":"ACC08764544","year":2021,"amount":28675.58758765888,"details":{"name":"Delila Beer","first_txn_date":"2021-05-19","updated_by":{"user":"IzB5ksXu","time":"2023-01-26T20:47:26.389Z"}},"transactions":[{"txn_date":"2021-10-01","amount":80995.23818711648},{"txn_date":"2021-05-19","amount":92572.40049217848},{"txn_date":"2021-12-11","amount":99398.79832225188}]}
+{"account_id":"ACC62505420","year":2023,"amount":96125.3125884202,"details":{"name":"Shawn Goodwin","updated_by":{"user":"F3dqIvYp2pFtena4","time":"2023-02-11T04:38:29.832Z"}},"transactions":[]}
+
+

Let's also check if there is a corresponding record in the CSV file.

+
$ cat docker/sample/csv/account/part-0000* | grep ACC03093143
+ACC03093143,2023,Nadine Heidenreich Jr.,"{\"account_id\":\"ACC03093143\",\"year\":2023,\"amount\":87990.37196728592,\"details\":{\"name\":\"Nadine Heidenreich Jr.\",\"first_txn_date\":\"2021-11-09\",\"updated_by\":{\"user\":\"YfEyJCe8ohrl0j IfyT\",\"time\":\"2022-09-26T20:47:53.404Z\"}},\"transactions\":[{\"txn_date\":\"2021-11-09\",\"amount\":97073.7914706189}]}"
+
+

Great! The account, year, name and payload look to all match up.

+

Additional Topics

+

Order of execution

+

You may notice that the events are generated first, then the CSV file. This is because as part of the execute +function, we passed in the kafkaTask first, before the csvTask. You can change the order of execution by +passing in csvTask before kafkaTask into the execute function.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/guide/scenario/delete-generated-data/index.html b/setup/guide/scenario/delete-generated-data/index.html new file mode 100644 index 00000000..d7fe0bdf --- /dev/null +++ b/setup/guide/scenario/delete-generated-data/index.html @@ -0,0 +1,2300 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Delete Generated Data - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Delete Generated Data

+
+

Info

+

Delete generated data is a paid feature. Try the free trial here.

+
+

Creating a data generator for Postgres and delete the generated data after using it.

+

Requirements

+
    +
  • 5 minutes
    • +
  • Git
    • +
  • Gradle
    • +
  • Docker
    • +
+

Get Started

+

First, we will clone the data-caterer-example repo which will already have the base project setup required.

+
git clone git@github.com:pflooky/data-caterer-example.git
+
+

Plan Setup

+

Create a new Java or Scala class.

+
    +
  • Java: src/main/java/com/github/pflooky/plan/MyAdvancedDeleteJavaPlanRun.java
    • +
  • Scala: src/main/scala/com/github/pflooky/plan/MyAdvancedDeletePlanRun.scala
    • +
+

Make sure your class extends PlanRun.

+
+
+
+
import com.github.pflooky.datacaterer.java.api.PlanRun;
+...
+
+public class MyAdvancedDeleteJavaPlanRun extends PlanRun {
+    {
+        var autoRun = configuration()
+                .postgres("my_postgres", "jdbc:postgresql://host.docker.internal:5432/customer")  (1)
+                .enableGeneratePlanAndTasks(true)                                                 (2)
+                .enableRecordTracking(true)                                                       (3)
+                .enableDeleteGeneratedRecords(false)                                              (4)
+                .enableUniqueCheck(true)
+                .generatedPlanAndTaskFolderPath("/opt/app/data/generated")                        (5)
+                .recordTrackingFolderPath("/opt/app/data/recordTracking")                         (6)
+                .generatedReportsFolderPath("/opt/app/data/report");
+
+        execute(autoRun);
+   }
+}
+
+
+
+
import com.github.pflooky.datacaterer.api.PlanRun
+...
+
+class MyAdvancedDeletePlanRun extends PlanRun {
+
+  val autoRun = configuration
+    .postgres("my_postgres", "jdbc:postgresql://host.docker.internal:5432/customer")  (1)
+    .enableGeneratePlanAndTasks(true)                                                 (2)
+    .enableRecordTracking(true)                                                       (3)
+    .enableDeleteGeneratedRecords(false)                                              (4)
+    .enableUniqueCheck(true)
+    .generatedPlanAndTaskFolderPath("/opt/app/data/generated")                        (5)
+    .recordTrackingFolderPath("/opt/app/data/recordTracking")                         (6)
+    .generatedReportsFolderPath("/opt/app/data/report")
+
+  execute(configuration = autoRun)
+}
+
+
+
+
+

In the above code we note the following:

+
    +
  1. We have defined a Postgres connection called my_postgres
    2. +
  2. enableGeneratePlanAndTasks is enabled to auto generate data for all tables under customer database
    3. +
  3. enableRecordTracking is enabled to ensure that all generated records are tracked. This will get used when we want + to delete data afterwards
    4. +
  4. enableDeleteGeneratedRecords is disabled for now. We want to see the generated data first and delete sometime after
    5. +
  5. generatedPlanAndTaskFolderPath is the folder path where we saved the metadata we have gathered from my_postgres
    6. +
  6. recordTrackingFolderPath is the folder path where record tracking is maintained. We need to persist this data to + ensure it is still available when we want to delete data
    7. +
+

Postgres Setup

+

If you don't have your own Postgres up and running, you can set up and run an instance configured in the docker +folder via.

+
cd docker
+docker-compose up -d postgres
+docker exec docker-postgresserver-1 psql -Upostgres -d customer -c '\dt+ account.*'
+
+

This will create the tables found under docker/data/sql/postgres/customer.sql. You can change this file to contain +your own tables. We can see there are 4 tables created for us, accounts, balances, transactions and mapping.

+

Run

+

Let's try run.

+
cd ..
+./run.sh
+#input class MyAdvancedDeleteJavaPlanRun or MyAdvancedDeletePlanRun
+#after completing
+docker exec docker-postgresserver-1 psql -Upostgres -d customer -c 'select * from account.accounts limit 1'
+
+

It should look something like this.

+
   id   | account_number  | account_status | created_by | created_by_fixed_length | customer_id_int | customer_id_smallint | customer_id_bigint |   customer_id_decimal    | customer_id_real | customer_id_double | open_date  |     open_timestamp      | last_opened_time |                                                           payload_bytes
+--------+-----------------+----------------+------------+-------------------------+-----------------+----------------------+--------------------+--------------------------+------------------+--------------------+------------+-------------------------+------------------+------------------------------------------------------------------------------------------------------------------------------------
+ 100414 | 5uROOVOUyQUbubN | h3H            | SfA0eZJcTm | CuRw                    |              13 |                   42 |               6041 | 76987.745612542900000000 |         91866.78 |  66400.37433202339 | 2023-03-05 | 2023-08-14 11:33:11.343 | 23:58:01.736     | \x604d315d4547616e6a233050415373317274736f5e682d516132524f3d23233c37463463322f342d34376d597e665d6b3d395b4238284028622b7d6d2b4f5042
+(1 row)
+
+

The data that gets inserted will follow the foreign keys that are defined within Postgres and also ensure the insertion +order is correct.

+

Check the number of records via:

+
docker exec docker-postgresserver-1 psql -Upostgres -d customer -c 'select count(1) from account.accounts'
+#open report under docker/sample/report/index.html
+
+

Delete

+

We are now at a stage where we want to delete the data that was generated. All we need to do is flip two flags.

+
.enableDeleteGeneratedRecords(true)
+.enableGenerateData(false)  //we need to explicitly disable generating data
+
+

Enable delete generated records and disable generating data.

+

Before we run again, let us insert a record manually to see if that data will survive after running the job to delete +the generated data.

+
docker exec docker-postgresserver-1 psql -Upostgres -d customer -c "insert into account.accounts (account_number) values ('my_account_number')"
+docker exec docker-postgresserver-1 psql -Upostgres -d customer -c "select count(1) from account.accounts"
+
+

We now should have 1001 records in our account.accounts table. Let's delete the generated data now.

+
./run.sh
+#input class MyAdvancedDeleteJavaPlanRun or MyAdvancedDeletePlanRun
+#after completing
+docker exec docker-postgresserver-1 psql -Upostgres -d customer -c 'select * from account.accounts limit 1'
+docker exec docker-postgresserver-1 psql -Upostgres -d customer -c 'select count(1) from account.accounts'
+
+

You should see that only 1 record is left, the one that we manually inserted. Great, now we can generate data reliably +and also be able to clean it up.

+

Additional Topics

+

One class for generating, another for deleting?

+

Yes, this is possible. There are two requirements: +- the connection names used need to be the same across both classes +- recordTrackingFolderPath needs to be set to the same value

+

Define record count

+

You can control the record count per sub data source via numRecordsPerStep.

+
+
+
+
var autoRun = configuration()
+      ...
+      .numRecordsPerStep(100)
+
+execute(autoRun)
+
+
+
+
val autoRun = configuration
+  ...
+  .numRecordsPerStep(100)
+
+execute(configuration = autoRun)
+
+
+
+
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/guide/scenario/first-data-generation/index.html b/setup/guide/scenario/first-data-generation/index.html new file mode 100644 index 00000000..4b105c1c --- /dev/null +++ b/setup/guide/scenario/first-data-generation/index.html @@ -0,0 +1,3020 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Files (CSV, JSON, ORC, Parquet) - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

First Data Generation

+

Creating a data generator for a CSV file.

+

Requirements

+
    +
  • 20 minutes
    • +
  • Git
    • +
  • Gradle
    • +
  • Docker
    • +
+

Get Started

+

First, we will clone the data-caterer-example repo which will already have the base project setup required.

+
git clone git@github.com:pflooky/data-caterer-example.git
+
+

Plan Setup

+

Create a new Java or Scala class.

+
    +
  • Java: src/main/java/com/github/pflooky/plan/MyCsvPlan.java
    • +
  • Scala: src/main/scala/com/github/pflooky/plan/MyCsvPlan.scala
    • +
+

Make sure your class extends PlanRun.

+
+
+
+
import com.github.pflooky.datacaterer.java.api.PlanRun;
+
+public class MyCsvJavaPlan extends PlanRun {
+}
+
+
+
+
import com.github.pflooky.datacaterer.api.PlanRun
+
+class MyCsvPlan extends PlanRun {
+}
+
+
+
+
+

This class defines where we need to define all of our configurations for generating data. There are helper variables and +methods defined to make it simple and easy to use.

+

Connection Configuration

+

When dealing with CSV files, we need to define a path for our generated CSV files to be saved at, along with any other +high level configurations.

+
+
+
+
csv(
+  "customer_accounts",              //name
+  "/opt/app/data/customer/account", //path
+  Map.of("header", "true")          //optional additional options
+)
+
+

Other additional options for CSV can be found here

+
+
+
csv(
+  "customer_accounts",              //name
+  "/opt/app/data/customer/account", //path
+  Map("header" -> "true")           //optional additional options
+)
+
+

Other additional options for CSV can be found here

+
+
+
+

Schema

+

Our CSV file that we generate should adhere to a defined schema where we can also define data types.

+

Let's define each field along with their corresponding data type. You will notice that the string fields do not have a +data type defined. This is because the default data type is StringType.

+
+
+
+
var accountTask = csv("customer_accounts", "/opt/app/data/customer/account", Map.of("header", "true"))
+        .schema(
+                field().name("account_id"),
+                field().name("balance").type(DoubleType.instance()),
+                field().name("created_by"),
+                field().name("name"),
+                field().name("open_time").type(TimestampType.instance()),
+                field().name("status")
+        );
+
+
+
+
val accountTask = csv("customer_accounts", "/opt/app/data/customer/account", Map("header" -> "true"))
+  .schema(
+    field.name("account_id"),
+    field.name("balance").`type`(DoubleType),
+    field.name("created_by"),
+    field.name("name"),
+    field.name("open_time").`type`(TimestampType),
+    field.name("status")
+  )
+
+
+
+
+

Field Metadata

+

We could stop here and generate random data for the accounts table. But wouldn't it be more useful if we produced data +that is closer to the structure of the data that would come in production? We can do this by defining various metadata +attributes that add guidelines that the data generator will understand when generating data.

+
account_id
+
    +
  • account_id follows a particular pattern that where it starts with ACC and has 8 digits after it. + This can be defined via a regex like below. Alongside, we also mention that values are unique ensure that + unique values are generated.
    • +
+
+
+
+
field().name("account_id").regex("ACC[0-9]{8}").unique(true),
+
+
+
+
field.name("account_id").regex("ACC[0-9]{8}").unique(true),
+
+
+
+
+
balance
+
    +
  • balance let's make the numbers not too large, so we can define a min and max for the generated numbers to be between + 1 and 1000.
    • +
+
+
+
+
field().name("balance").type(DoubleType.instance()).min(1).max(1000),
+
+
+
+
field.name("balance").`type`(DoubleType).min(1).max(1000),
+
+
+
+
+
name
+
    +
  • name is a string that also follows a certain pattern, so we could also define a regex but here we will choose to + leverage the DataFaker library and create an expression to generate real looking name. All possible faker + expressions + can be found here
    • +
+
+
+
+
field().name("name").expression("#{Name.name}"),
+
+
+
+
field.name("name").expression("#{Name.name}"),
+
+
+
+
+
open_time
+
    +
  • open_time is a timestamp that we want to have a value greater than a specific date. We can define a min date by + using + java.sql.Date like below.
    • +
+
+
+
+
field().name("open_time").type(TimestampType.instance()).min(java.sql.Date.valueOf("2022-01-01")),
+
+
+
+
field.name("open_time").`type`(TimestampType).min(java.sql.Date.valueOf("2022-01-01")),
+
+
+
+
+
status
+
    +
  • status is a field that can only obtain one of four values, open, closed, suspended or pending.
    • +
+
+
+
+
field().name("status").oneOf("open", "closed", "suspended", "pending")
+
+
+
+
field.name("status").oneOf("open", "closed", "suspended", "pending")
+
+
+
+
+
created_by
+
    +
  • created_by is a field that is based on the status field where it follows the + logic: if status is open or closed, then + it is created_by eod else created_by event. This can be achieved by defining a SQL expression like below.
    • +
+
+
+
+
field().name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+
+
+
+
field.name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+
+
+
+
+

Putting it all the fields together, our class should now look like this.

+
+
+
+
var accountTask = csv("customer_accounts", "/opt/app/data/customer/account", Map.of("header", "true"))
+        .schema(
+                field().name("account_id").regex("ACC[0-9]{8}").unique(true),
+                field().name("balance").type(DoubleType.instance()).min(1).max(1000),
+                field().name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+                field().name("name").expression("#{Name.name}"),
+                field().name("open_time").type(TimestampType.instance()).min(java.sql.Date.valueOf("2022-01-01")),
+                field().name("status").oneOf("open", "closed", "suspended", "pending")
+        );
+
+
+
+
val accountTask = csv("customer_accounts", "/opt/app/data/customer/account", Map("header" -> "true"))
+  .schema(
+    field.name("account_id").regex("ACC[0-9]{8}").unique(true),
+    field.name("balance").`type`(DoubleType).min(1).max(1000),
+    field.name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+    field.name("name").expression("#{Name.name}"),
+    field.name("open_time").`type`(TimestampType).min(java.sql.Date.valueOf("2022-01-01")),
+    field.name("status").oneOf("open", "closed", "suspended", "pending")
+  )
+
+
+
+
+

Record Count

+

We only want to generate 100 records, so that we can see what the output looks like. This is controlled at the +accountTask level like below. If you want to generate more records, set it to the value you want.

+
+
+
+
var accountTask = csv("customer_accounts", "/opt/app/data/customer/account", Map.of("header", "true"))
+        .schema(
+                ...
+        )
+        .count(count().records(100));
+
+
+
+
val accountTask = csv("customer_accounts", "/opt/app/data/customer/account", Map("header" -> "true"))
+  .schema(
+    ...
+  )
+  .count(count.records(100))
+
+
+
+
+

Additional Configurations

+

At the end of data generation, a report gets generated that summarises the actions it performed. We can control the +output folder of that report via configurations. We will also enable the unique check to ensure any unique fields will +have unique values generated.

+
+
+
+
var config = configuration()
+        .generatedReportsFolderPath("/opt/app/data/report")
+        .enableUniqueCheck(true);
+
+
+
+
val config = configuration
+  .generatedReportsFolderPath("/opt/app/data/report")
+  .enableUniqueCheck(true)
+
+
+
+
+

Execute

+

To tell Data Caterer that we want to run with the configurations along with the accountTask, we have to call execute +. So our full plan run will look like this.

+
+
+
+
public class MyCsvJavaPlan extends PlanRun {
+    {
+        var accountTask = csv("customer_accounts", "/opt/app/data/customer/account", Map.of("header", "true"))
+                .schema(
+                        field().name("account_id").regex("ACC[0-9]{8}").unique(true),
+                        field().name("balance").type(DoubleType.instance()).min(1).max(1000),
+                        field().name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+                        field().name("name").expression("#{Name.name}"),
+                        field().name("open_time").type(TimestampType.instance()).min(java.sql.Date.valueOf("2022-01-01")),
+                        field().name("status").oneOf("open", "closed", "suspended", "pending")
+                );
+
+        var config = configuration()
+                .generatedReportsFolderPath("/opt/app/data/report")
+                .enableUniqueCheck(true);
+
+        execute(config, accountTask);
+    }
+}
+
+
+
+
class MyCsvPlan extends PlanRun {
+
+  val accountTask = csv("customer_accounts", "/opt/app/data/customer/account", Map("header" -> "true"))
+    .schema(
+      field.name("account_id").regex("ACC[0-9]{8}").unique(true),
+      field.name("balance").`type`(DoubleType).min(1).max(1000),
+      field.name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+      field.name("name").expression("#{Name.name}"),
+      field.name("open_time").`type`(TimestampType).min(java.sql.Date.valueOf("2022-01-01")),
+      field.name("status").oneOf("open", "closed", "suspended", "pending")
+    )
+    val config = configuration
+      .generatedReportsFolderPath("/opt/app/data/report")
+      .enableUniqueCheck(true)
+
+    execute(config, accountTask)
+}
+
+
+
+
+

Run

+

Now we can run via the script ./run.sh that is in the top level directory of the data-caterer-example to run the +class we just +created.

+
./run.sh
+#input class MyCsvJavaPlan or MyCsvPlan
+#after completing
+head docker/sample/customer/account/part-00000*
+
+

Your output should look like this.

+
account_id,balance,created_by,name,open_time,status
+ACC06192462,853.9843359645766,eod,Hoyt Kertzmann MD,2023-07-22T11:17:01.713Z,closed
+ACC15350419,632.5969895326234,eod,Dr. Claude White,2022-12-13T21:57:56.840Z,open
+ACC25134369,592.0958847218986,eod,Fabian Rolfson,2023-04-26T04:54:41.068Z,open
+ACC48021786,656.6413439322964,eod,Dewayne Stroman,2023-05-17T06:31:27.603Z,open
+ACC26705211,447.2850352884595,event,Garrett Funk,2023-07-14T03:50:22.746Z,pending
+ACC03150585,750.4568929015996,event,Natisha Reichel,2023-04-11T11:13:10.080Z,suspended
+ACC29834210,686.4257811608622,event,Gisele Ondricka,2022-11-15T22:09:41.172Z,suspended
+ACC39373863,583.5110618128994,event,Thaddeus Ortiz,2022-09-30T06:33:57.193Z,suspended
+ACC39405798,989.2623959059525,eod,Shelby Reinger,2022-10-23T17:29:17.564Z,open
+
+

Also check the HTML report, found at docker/sample/report/index.html, that gets generated to get an overview of what +was executed.

+

Sample report

+

Join With Another CSV

+

Now that we have generated some accounts, let's also try to generate a set of transactions for those accounts in CSV +format as well. The transactions could be in any other format, but to keep this simple, we will continue using CSV.

+

We can define our schema the same way along with any additional metadata.

+
+
+
+
var transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map.of("header", "true"))
+        .schema(
+                field().name("account_id"),
+                field().name("name"),
+                field().name("amount").type(DoubleType.instance()).min(1).max(100),
+                field().name("time").type(TimestampType.instance()).min(java.sql.Date.valueOf("2022-01-01")),
+                field().name("date").type(DateType.instance()).sql("DATE(time)")
+        );
+
+
+
+
val transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map("header" -> "true"))
+  .schema(
+    field.name("account_id"),
+    field.name("full_name"),
+    field.name("amount").`type`(DoubleType).min(1).max(100),
+    field.name("time").`type`(TimestampType).min(java.sql.Date.valueOf("2022-01-01")),
+    field.name("date").`type`(DateType).sql("DATE(time)")
+  )
+
+
+
+
+

Records Per Column

+

Usually, for a given account_id, full_name, there should be multiple records for it as we want to simulate a customer +having multiple transactions. We can achieve this through defining the number of records to generate in the count +function.

+
+
+
+
var transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map.of("header", "true"))
+        .schema(
+                ...
+        )
+        .count(count().recordsPerColumn(5, "account_id", "full_name"));
+
+
+
+
val transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map("header" -> "true"))
+  .schema(
+    ...
+  )
+  .count(count.recordsPerColumn(5, "account_id", "full_name"))
+
+
+
+
+
Random Records Per Column
+

Above, you will notice that we are generating 5 records per account_id, full_name. This is okay but still not quite +reflective of the real world. Sometimes, people have accounts with no transactions in them, or they could have many. We +can accommodate for this via defining a random number of records per column.

+
+
+
+
var transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map.of("header", "true"))
+        .schema(
+                ...
+        )
+        .count(count().recordsPerColumnGenerator(generator().min(0).max(5), "account_id", "full_name"));
+
+
+
+
val transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map("header" -> "true"))
+  .schema(
+    ...
+  )
+  .count(count.recordsPerColumnGenerator(generator.min(0).max(5), "account_id", "full_name"))
+
+
+
+
+

Here we set the minimum number of records per column to be 0 and the maximum to 5.

+

Foreign Key

+

In this scenario, we want to match the account_id in account to match the same column values in transaction. We +also want to match name in account to full_name in transaction. This can be done via plan configuration like +below.

+
+
+
+
var myPlan = plan().addForeignKeyRelationship(
+        accountTask, List.of("account_id", "name"), //the task and columns we want linked
+        List.of(Map.entry(transactionTask, List.of("account_id", "full_name"))) //list of other tasks and their respective column names we want matched
+);
+
+
+
+
val myPlan = plan.addForeignKeyRelationship(
+  accountTask, List("account_id", "name"),  //the task and columns we want linked
+  List(transactionTask -> List("account_id", "full_name"))  //list of other tasks and their respective column names we want matched
+)
+
+
+
+
+

Now, stitching it all together for the execute function, our final plan should look like this.

+
+
+
+
public class MyCsvJavaPlan extends PlanRun {
+    {
+        var accountTask = csv("customer_accounts", "/opt/app/data/customer/account", Map.of("header", "true"))
+                .schema(
+                        field().name("account_id").regex("ACC[0-9]{8}").unique(true),
+                        field().name("balance").type(DoubleType.instance()).min(1).max(1000),
+                        field().name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+                        field().name("name").expression("#{Name.name}"),
+                        field().name("open_time").type(TimestampType.instance()).min(java.sql.Date.valueOf("2022-01-01")),
+                        field().name("status").oneOf("open", "closed", "suspended", "pending")
+                )
+                .count(count().records(100));
+
+        var transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map.of("header", "true"))
+                .schema(
+                        field().name("account_id"),
+                        field().name("name"),
+                        field().name("amount").type(DoubleType.instance()).min(1).max(100),
+                        field().name("time").type(TimestampType.instance()).min(java.sql.Date.valueOf("2022-01-01")),
+                        field().name("date").type(DateType.instance()).sql("DATE(time)")
+                )
+                .count(count().recordsPerColumnGenerator(generator().min(0).max(5), "account_id", "full_name"));
+
+        var config = configuration()
+                .generatedReportsFolderPath("/opt/app/data/report")
+                .enableUniqueCheck(true);
+
+        var myPlan = plan().addForeignKeyRelationship(
+                accountTask, List.of("account_id", "name"),
+                List.of(Map.entry(transactionTask, List.of("account_id", "full_name")))
+        );
+
+        execute(myPlan, config, accountTask, transactionTask);
+    }
+}
+
+
+
+
class MyCsvPlan extends PlanRun {
+
+  val accountTask = csv("customer_accounts", "/opt/app/data/customer/account", Map("header" -> "true"))
+    .schema(
+      field.name("account_id").regex("ACC[0-9]{8}").unique(true),
+      field.name("balance").`type`(DoubleType).min(1).max(1000),
+      field.name("created_by").sql("CASE WHEN status IN ('open', 'closed') THEN 'eod' ELSE 'event' END"),
+      field.name("name").expression("#{Name.name}"),
+      field.name("open_time").`type`(TimestampType).min(java.sql.Date.valueOf("2022-01-01")),
+      field.name("status").oneOf("open", "closed", "suspended", "pending")
+    )
+    .count(count.records(100))
+
+  val transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map("header" -> "true"))
+    .schema(
+      field.name("account_id"),
+      field.name("name"),
+      field.name("amount").`type`(DoubleType).min(1).max(100),
+      field.name("time").`type`(TimestampType).min(java.sql.Date.valueOf("2022-01-01")),
+      field.name("date").`type`(DateType).sql("DATE(time)")
+    )
+    .count(count.recordsPerColumnGenerator(generator.min(0).max(5), "account_id", "full_name"))
+
+  val config = configuration
+    .generatedReportsFolderPath("/opt/app/data/report")
+    .enableUniqueCheck(true)
+
+  val myPlan = plan.addForeignKeyRelationship(
+    accountTask, List("account_id", "name"),
+    List(transactionTask -> List("account_id", "full_name"))
+  )
+
+  execute(myPlan, config, accountTask, transactionTask)
+}
+
+
+
+
+

Let's try run again.

+
#clean up old data
+rm -rf docker/sample/customer/account
+./run.sh
+#input class MyCsvJavaPlan or MyCsvPlan
+#after completing, let's pick an account and check the transactions for that account
+account=$(tail -1 docker/sample/customer/account/part-00000* | awk -F "," '{print $1 "," $4}')
+echo $account
+cat docker/sample/customer/transaction/part-00000* | grep $account
+
+

It should look something like this.

+
ACC29117767,Willodean Sauer
+ACC29117767,Willodean Sauer,84.99145871948083,2023-05-14T09:55:51.439Z,2023-05-14
+ACC29117767,Willodean Sauer,58.89345733567232,2022-11-22T07:38:20.143Z,2022-11-22
+
+

Congratulations! You have now made a data generator that has simulated a real world data scenario. You can check the +DocumentationJavaPlanRun.java or DocumentationPlanRun.scala files as well to check that your plan is the same.

+

We can now look to consume this CSV data from a job or service. Usually, once we have consumed the data, we would also +want to check and validate that our consumer has correctly ingested the data.

+

Validate

+

In this scenario, our consumer will read in the CSV file, do some transformations, and then save the data to Postgres. +Let's try to configure data validations for the data that gets pushed into Postgres.

+

Postgres setup

+

First, we define our connection properties for Postgres. You can check out the full options available +here.

+
+
+
+
var postgresValidateTask = postgres(
+    "my_postgres",                                          //connection name
+    "jdbc:postgresql://host.docker.internal:5432/customer", //url
+    "postgres",                                             //username
+    "password"                                              //password
+).table("account", "transactions");
+
+
+
+
val postgresValidateTask = postgres(
+  "my_postgres",                                          //connection name
+  "jdbc:postgresql://host.docker.internal:5432/customer", //url
+  "postgres",                                             //username
+  "password"                                              //password
+).table("account", "transactions")
+
+
+
+
+

We can connect and access the data inside the table account.transactions. Now to define our data validations.

+

Validations

+

For full information about validation options and configurations, check here. +Below, we have an example that should give you a good understanding of what validations are possible.

+
+
+
+
var postgresValidateTask = postgres(...)
+        .table("account", "transactions")
+        .validations(
+                validation().col("account_id").isNotNull(),
+                validation().col("name").matches("[A-Z][a-z]+ [A-Z][a-z]+").errorThreshold(0.2).description("Some names have different formats"),
+                validation().col("balance").greaterThanOrEqual(0).errorThreshold(10).description("Account can have negative balance if overdraft"),
+                validation().expr("CASE WHEN status == 'closed' THEN isNotNull(close_date) ELSE isNull(close_date) END"),
+                validation().unique("account_id", "name"),
+                validation().groupBy("account_id", "name").max("login_retry").lessThan(10)
+        );
+
+
+
+
val postgresValidateTask = postgres(...)
+  .table("account", "transactions")
+  .validations(
+    validation.col("account_id").isNotNull,
+    validation.col("name").matches("[A-Z][a-z]+ [A-Z][a-z]+").errorThreshold(0.2).description("Some names have different formats"),
+    validation.col("balance").greaterThanOrEqual(0).errorThreshold(10).description("Account can have negative balance if overdraft"),
+    validation.expr("CASE WHEN status == 'closed' THEN isNotNull(close_date) ELSE isNull(close_date) END"),
+    validation.unique("account_id", "name"),
+    validation.groupBy("account_id", "name").max("login_retry").lessThan(10)
+  )
+
+
+
+
+
name
+

For all values in the name column, we check if they match the regex [A-Z][a-z]+ [A-Z][a-z]+. As we know in the real +world, names do not always follow the same pattern, so we allow for an errorThreshold before marking the validation +as failed. Here, we define the errorThreshold to be 0.2, which means, if the error percentage is greater than 20%, +then fail the validation. We also append on a helpful description so other developers/users can understand the context +of the validation.

+
balance
+

We check that all balance values are greater than or equal to 0. This time, we have a slightly different +errorThreshold as it is set to 10, which means, if the number of errors is greater than 10, then fail the +validation.

+
expr
+

Sometimes, we may need to include the values of multiple columns to validate a certain condition. This is where we can +use expr to define a SQL expression that returns a boolean. In this scenario, we are checking if the status column +has value closed, then the close_date should be not null, otherwise, close_date is null.

+
unique
+

We check whether the combination of account_id and name are unique within the dataset. You can define one or more +columns for unique validations.

+
groupBy
+

There may be some business rule that states the number of login_retry should be less than 10 for each account. We can +check this via a group by validation where we group by the account_id, name, take the maximum value +for login_retry per account_id,name combination, then check if it is less than 10.

+

You can now look to play around with other configurations or data sources to meet your needs. Also, make sure to explore +the docs further as it can guide you on what can be configured.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/guide/scenario/records-per-column/index.html b/setup/guide/scenario/records-per-column/index.html new file mode 100644 index 00000000..631e9f21 --- /dev/null +++ b/setup/guide/scenario/records-per-column/index.html @@ -0,0 +1,2264 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Multiple Records Per Column Value - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Multiple Records Per Column

+

Creating a data generator for a CSV file where there are multiple records per column values.

+

Requirements

+
    +
  • 5 minutes
    • +
  • Git
    • +
  • Gradle
    • +
  • Docker
    • +
+

Get Started

+

First, we will clone the data-caterer-example repo which will already have the base project setup required.

+
git clone git@github.com:pflooky/data-caterer-example.git
+
+

Plan Setup

+

Create a new Java or Scala class.

+
    +
  • Java: src/main/java/com/github/pflooky/plan/MyMultipleRecordsPerColJavaPlan.java
    • +
  • Scala: src/main/scala/com/github/pflooky/plan/MyMultipleRecordsPerColPlan.scala
    • +
+

Make sure your class extends PlanRun.

+
+
+
+
import com.github.pflooky.datacaterer.java.api.PlanRun;
+...
+
+public class MyMultipleRecordsPerColJavaPlan extends PlanRun {
+    {
+        var transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map.of("header", "true"))
+                .schema(
+                        field().name("account_id"),
+                        field().name("full_name"),
+                        field().name("amount").type(DoubleType.instance()).min(1).max(100),
+                        field().name("time").type(TimestampType.instance()).min(java.sql.Date.valueOf("2022-01-01")),
+                        field().name("date").type(DateType.instance()).sql("DATE(time)")
+                )
+
+        var config = configuration()
+                .generatedReportsFolderPath("/opt/app/data/report")
+                .enableUniqueCheck(true);
+
+        execute(config, transactionTask);
+    }
+}
+
+
+
+
import com.github.pflooky.datacaterer.api.PlanRun
+...
+
+class MyMultipleRecordsPerColPlan extends PlanRun {
+
+  val transactionTask: ConnectionTaskBuilder[FileBuilder] = csv("customer_transactions", "/opt/app/data/customer/transaction", Map("header" -> "true"))
+    .schema(
+      field.name("account_id").regex("ACC[0-9]{8}"), 
+      field.name("full_name").expression("#{Name.name}"), 
+      field.name("amount").`type`(DoubleType.instance).min(1).max(100),
+      field.name("time").`type`(TimestampType.instance).min(java.sql.Date.valueOf("2022-01-01")), 
+      field.name("date").`type`(DateType.instance).sql("DATE(time)")
+    )
+
+  val config = configuration
+    .generatedReportsFolderPath("/opt/app/data/report")
+
+  execute(config, transactionTask)
+}
+
+
+
+
+

Record Count

+

By default, tasks will generate 1000 records. You can alter this value via the count configuration which can be +applied to individual tasks. For example, in Scala, csv(...).count(count.records(100)) to generate only 100 records.

+

Records Per Column

+

In this scenario, for a given account_id, full_name, there should be multiple records for it as we want to simulate a +customer having multiple transactions. We can achieve this through defining the number of records to generate in +the count function.

+
+
+
+
var transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map.of("header", "true"))
+        .schema(
+                ...
+        )
+        .count(count().recordsPerColumn(5, "account_id", "full_name"));
+
+
+
+
val transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map("header" -> "true"))
+  .schema(
+    ...
+  )
+  .count(count.recordsPerColumn(5, "account_id", "full_name"))
+
+
+
+
+

This will generate 1000 * 5 = 5000 records as the default number of records is set (1000) and +per account_id, full_name from the initial 1000 records, 5 records will be generated.

+

Random Records Per Column

+

Generating 5 records per column is okay but still not quite reflective of the real world. Sometimes, people have +accounts with no transactions in them, or they could have many. We can accommodate for this via defining a random number +of records per column.

+
+
+
+
var transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map.of("header", "true"))
+        .schema(
+                ...
+        )
+        .count(count().recordsPerColumnGenerator(generator().min(0).max(5), "account_id", "full_name"));
+
+
+
+
val transactionTask = csv("customer_transactions", "/opt/app/data/customer/transaction", Map("header" -> "true"))
+  .schema(
+    ...
+  )
+  .count(count.recordsPerColumnGenerator(generator.min(0).max(5), "account_id", "full_name"))
+
+
+
+
+

Here we set the minimum number of records per column to be 0 and the maximum to 5. This will follow a uniform +distribution so the average number of records per account is 2.5. We could also define other metadata, +just like we did with fields, when defining the generator. For example, we could set standardDeviation and mean for +the number of records generated per column to follow a normal distribution.

+

Run

+

Let's try run.

+
#clean up old data
+rm -rf docker/sample/customer/account
+./run.sh
+#input class MyMultipleRecordsPerColJavaPlan or MyMultipleRecordsPerColPlan
+#after completing
+head docker/sample/customer/transaction/part-00000*
+
+

It should look something like this.

+
ACC29117767,Willodean Sauer
+ACC29117767,Willodean Sauer,84.99145871948083,2023-05-14T09:55:51.439Z,2023-05-14
+ACC29117767,Willodean Sauer,58.89345733567232,2022-11-22T07:38:20.143Z,2022-11-22
+
+

You can now look to play around with other count configurations found here.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/index.html b/setup/index.html new file mode 100644 index 00000000..6c9b2007 --- /dev/null +++ b/setup/index.html @@ -0,0 +1,2082 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Setup - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Setup

+

All the configurations and customisation related to Data Caterer can be found under here.

+

Guide

+

If you want a guided tour of using the Java or Scala API, you can follow one of the guides found here.

+

Specific Configuration

+
+
    +
  • Configurations - Configurations relating to feature flags, folder pathways, metadata + analysis
    • +
  • Connections - Explore the data source connections available
    • +
  • Generators - Choose and configure the type of generator you want used for + fields
    • +
  • Validations - How to validate data to ensure your system is performing as expected
    • +
  • Foreign Keys - Define links between data elements across data sources
    • +
  • Deployment - Deploy Data Caterer as a job to your chosen environment
    • +
  • Advanced - Advanced usage of Data Caterer
    • +
+
+

High Level Run Configurations

+

High level run configurations

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/validation/basic-validation/index.html b/setup/validation/basic-validation/index.html new file mode 100644 index 00000000..ec006eeb --- /dev/null +++ b/setup/validation/basic-validation/index.html @@ -0,0 +1,3047 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Basic - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Basic Validations

+

Run validations on a column to ensure the values adhere to your requirement. Can be set to complex validation logic +via SQL expression as well if needed (see here).

+

Equal

+

Ensure all data in column is equal to certain value. Value can be of any data type.

+
+
+
+
validation().col("year").isEqual(2021)
+
+
+
+
validation.col("year").isEqual(2021)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "year == 2021"
+
+
+
+
+

Not Equal

+

Ensure all data in column is not equal to certain value. Value can be of any data type.

+
+
+
+
validation().col("year").isNotEqual(2021)
+
+
+
+
validation.col("year").isNotEqual(2021)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "year != 2021"
+
+
+
+
+

Null

+

Ensure all data in column is null.

+
+
+
+
validation().col("year").isNull()
+
+
+
+
validation.col("year").isNull
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "ISNULL(year)"
+
+
+
+
+

Not Null

+

Ensure all data in column is not null.

+
+
+
+
validation().col("year").isNotNull()
+
+
+
+
validation.col("year").isNotNull
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "ISNOTNULL(year)"
+
+
+
+
+

Contains

+

Ensure all data in column is contains certain string. Column has to have type string.

+
+
+
+
validation().col("name").contains("peter")
+
+
+
+
validation.col("name").contains("peter")
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "CONTAINS(name, 'peter')"
+
+
+
+
+

Not Contains

+

Ensure all data in column does not contain certain string. Column has to have type string.

+
+
+
+
validation().col("name").notContains("peter")
+
+
+
+
validation.col("name").notContains("peter")
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "!CONTAINS(name, 'peter')"
+
+
+
+
+

Unqiue

+

Ensure all data in column is unique.

+
+
+
+
validation().unique("account_id", "name")
+
+
+
+
validation.unique("account_id", "name")
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - unique: ["account_id", "name"]
+
+
+
+
+

Less Than

+

Ensure all data in column is less than certain value.

+
+
+
+
validation().col("amount").lessThan(100)
+
+
+
+
validation.col("amount").lessThan(100)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "amount < 100"
+
+
+
+
+

Less Than Or Equal

+

Ensure all data in column is less than or equal to certain value.

+
+
+
+
validation().col("amount").lessThanOrEqual(100)
+
+
+
+
validation.col("amount").lessThanOrEqual(100)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "amount <= 100"
+
+
+
+
+

Greater Than

+

Ensure all data in column is greater than certain value.

+
+
+
+
validation().col("amount").greaterThan(100)
+
+
+
+
validation.col("amount").greaterThan(100)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "amount > 100"
+
+
+
+
+

Greater Than Or Equal

+

Ensure all data in column is greater than or equal to certain value.

+
+
+
+
validation().col("amount").greaterThanOrEqual(100)
+
+
+
+
validation.col("amount").greaterThanOrEqual(100)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "amount >= 100"
+
+
+
+
+

Between

+

Ensure all data in column is between two values.

+
+
+
+
validation().col("amount").between(100, 200)
+
+
+
+
validation.col("amount").between(100, 200)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "amount BETWEEN 100 AND 200"
+
+
+
+
+

Not Between

+

Ensure all data in column is not between two values.

+
+
+
+
validation().col("amount").notBetween(100, 200)
+
+
+
+
validation.col("amount").notBetween(100, 200)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "amount NOT BETWEEN 100 AND 200"
+
+
+
+
+

In

+

Ensure all data in column is in set of defined values.

+
+
+
+
validation().col("status").in("open", "closed")
+
+
+
+
validation.col("status").in("open", "closed")
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "status IN ('open', 'closed')"
+
+
+
+
+

Matches

+

Ensure all data in column matches certain regex expression.

+
+
+
+
validation().col("account_id").matches("ACC[0-9]{8}")
+
+
+
+
validation.col("account_id").matches("ACC[0-9]{8}")
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "REGEXP(account_id, ACC[0-9]{8})"
+
+
+
+
+

Not Matches

+

Ensure all data in column does not match certain regex expression.

+
+
+
+
validation().col("account_id").notMatches("^acc.*")
+
+
+
+
validation.col("account_id").notMatches("^acc.*")
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "!REGEXP(account_id, '^acc.*')"
+
+
+
+
+

Starts With

+

Ensure all data in column starts with certain string. Column has to have type string.

+
+
+
+
validation().col("account_id").startsWith("ACC")
+
+
+
+
validation.col("account_id").startsWith("ACC")
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "STARTSWITH(account_id, 'ACC')"
+
+
+
+
+

Not Starts With

+

Ensure all data in column does not start with certain string. Column has to have type string.

+
+
+
+
validation().col("account_id").notStartsWith("ACC")
+
+
+
+
validation.col("account_id").notStartsWith("ACC")
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "!STARTSWITH(account_id, 'ACC')"
+
+
+
+
+

Ends With

+

Ensure all data in column ends with certain string. Column has to have type string.

+
+
+
+
validation().col("account_id").endsWith("ACC")
+
+
+
+
validation.col("account_id").endsWith("ACC")
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "ENDWITH(account_id, 'ACC')"
+
+
+
+
+

Not Ends With

+

Ensure all data in column does not end with certain string. Column has to have type string.

+
+
+
+
validation().col("account_id").notEndsWith("ACC")
+
+
+
+
validation.col("account_id").notEndsWith("ACC")
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "!ENDWITH(account_id, 'ACC')"
+
+
+
+
+

Size

+

Ensure all data in column has certain size. Column has to have type array or map.

+
+
+
+
validation().col("transactions").size(5)
+
+
+
+
validation.col("transactions").size(5)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "SIZE(transactions, 5)"
+
+
+
+
+

Not Size

+

Ensure all data in column does not have certain size. Column has to have type array or map.

+
+
+
+
validation().col("transactions").notSize(5)
+
+
+
+
validation.col("transactions").notSize(5)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "SIZE(transactions) != 5"
+
+
+
+
+

Less Than Size

+

Ensure all data in column has size less than certain value. Column has to have type array or map.

+
+
+
+
validation().col("transactions").lessThanSize(5)
+
+
+
+
validation.col("transactions").lessThanSize(5)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "SIZE(transactions) < 5"
+
+
+
+
+

Less Than Or Equal Size

+

Ensure all data in column has size less than or equal to certain value. Column has to have type array or map.

+
+
+
+
validation().col("transactions").lessThanOrEqualSize(5)
+
+
+
+
validation.col("transactions").lessThanOrEqualSize(5)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "SIZE(transactions) <= 5"
+
+
+
+
+

Greater Than Size

+

Ensure all data in column has size greater than certain value. Column has to have type array or map.

+
+
+
+
validation().col("transactions").greaterThanSize(5)
+
+
+
+
validation.col("transactions").greaterThanSize(5)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "SIZE(transactions) > 5"
+
+
+
+
+

Greater Than Or Equal Size

+

Ensure all data in column has size greater than or equal to certain value. Column has to have type array or map.

+
+
+
+
validation().col("transactions").greaterThanOrEqualSize(5)
+
+
+
+
validation.col("transactions").greaterThanOrEqualSize(5)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "SIZE(transactions) >= 5"
+
+
+
+
+

Luhn Check

+

Ensure all data in column passes luhn check. Luhn check is used to validate credit card numbers and certain +identification numbers (see here for more details).

+
+
+
+
validation().col("credit_card").luhnCheck()
+
+
+
+
validation.col("credit_card").luhnCheck
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "LUHN_CHECK(credit_card)"
+
+
+
+
+

Has Type

+

Ensure all data in column has certain data type.

+
+
+
+
validation().col("id").hasType("string")
+
+
+
+
validation.col("id").hasType("string")
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  ...
+    validations:
+      - expr: "TYPEOF(id) == 'string'"
+
+
+
+
+

Expression

+

Ensure all data in column adheres to SQL expression defined that returns back a boolean. You can define complex logic in +here that could combine multiple columns.

+

For example, CASE WHEN status == 'open' THEN balance > 0 ELSE balance == 0 END would check all rows with status +open to have balance greater than 0, otherwise, check the balance is 0.

+
+
+
+
var csvTxns = csv("transactions", "/tmp/csv", Map.of("header", "true"))
+  .validations(
+    validation().expr("amount < 100"),
+    validation().expr("year == 2021").errorThreshold(0.1),  //equivalent to if error percentage is > 10%, then fail
+    validation().expr("REGEXP_LIKE(name, 'Peter .*')").errorThreshold(200)  //equivalent to if number of errors is > 200, then fail
+  );
+
+var conf = configuration().enableValidation(true);
+
+
+
+
val csvTxns = csv("transactions", "/tmp/csv", Map("header" -> "true"))
+  .validations(
+    validation.expr("amount < 100"),
+    validation.expr("year == 2021").errorThreshold(0.1),  //equivalent to if error percentage is > 10%, then fail
+    validation.expr("REGEXP_LIKE(name, 'Peter .*')").errorThreshold(200)  //equivalent to if number of errors is > 200, then fail
+  )
+
+val conf = configuration.enableValidation(true)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  transactions:
+    options:
+      path: "/tmp/csv"
+    validations:
+      - expr: "amount < 100"
+      - expr: "year == 2021"
+        errorThreshold: 0.1   #equivalent to if error percentage is > 10%, then fail
+      - expr: "REGEXP_LIKE(name, 'Peter .*')"
+        errorThreshold: 200   #equivalent to if number of errors is > 200, then fail
+        description: "Should be lots of Peters"
+
+#enableValidation inside application.conf
+
+
+
+
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/validation/group-by-validation/index.html b/setup/validation/group-by-validation/index.html new file mode 100644 index 00000000..1f852f43 --- /dev/null +++ b/setup/validation/group-by-validation/index.html @@ -0,0 +1,2160 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Group by/Aggregate - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Group By Validation

+

If you want to run aggregations based on a particular set of columns, you can do so via group by validations. An example +would be checking that the sum of amount is less than 1000 per account_id, year. The validations applied can +be one of the validations from above.

+

Sum

+

Check the sum of a columns values for each group adheres to validation.

+
+
+
+
validation().groupBy("account_id", "year").sum("amount").lessThan(1000)
+
+
+
+
validation.groupBy("account_id", "year").sum("amount").lessThan(1000)
+
+
+
+
+

Count

+

Check the count for each group adheres to validation.

+
+
+
+
validation().groupBy("account_id", "year").count("amount").lessThan(10)
+
+
+
+
validation.groupBy("account_id", "year").count("amount").lessThan(10)
+
+
+
+
+

Min

+

Check the min for each group adheres to validation.

+
+
+
+
validation().groupBy("account_id", "year").min("amount").greaterThan(0)
+
+
+
+
validation.groupBy("account_id", "year").min("amount").greaterThan(0)
+
+
+
+
+

Max

+

Check the max for each group adheres to validation.

+
+
+
+
validation().groupBy("account_id", "year").max("amount").lessThanOrEqual(100)
+
+
+
+
validation.groupBy("account_id", "year").max("amount").lessThanOrEqual(100)
+
+
+
+
+

Average

+

Check the average for each group adheres to validation.

+
+
+
+
validation().groupBy("account_id", "year").avg("amount").between(40, 60)
+
+
+
+
validation.groupBy("account_id", "year").avg("amount").between(40, 60)
+
+
+
+
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/setup/validation/validation/index.html b/setup/validation/validation/index.html new file mode 100644 index 00000000..cd37ef2d --- /dev/null +++ b/setup/validation/validation/index.html @@ -0,0 +1,2341 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Validations - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Validations

+

Validations can be used to run data checks after you have run the data generator or even as a standalone task. A report +summarising the success or failure of the validations is produced and can be examined for further investigation.

+
+
    +
  • Basic - Basic column level validations
    • +
  • Group by/Aggregate - Run aggregates over grouped data, then validate
    • +
  • [Relationship (Coming soon)] - Ensure record values exist in other datasets based on relationships
    • +
  • [Data Profile (Coming soon)] - Score how close the data profile of generated data is against the target data profile
    • +
+
+

Currently, SQL expression validations are supported (can see here +for reference what other expressions are valid), but will later be extended out to supported other validations such as +aggregates (group by account_number, sum of amounts should be greater than 100), ordering (transaction dates should be +in descending order), relationships (at least one transaction per account_number) or data profiling (how close produced +data profile is to expected data profile).

+

Define Validations

+

Full example validation can be found below. For more details, check out each of the subsections defined further below.

+
+
+
+
var csvTxns = csv("transactions", "/tmp/csv", Map.of("header", "true"))
+  .validations(
+    validation().col("amount").lessThan(100),
+    validation().col("year").isEqual(2021).errorThreshold(0.1),  //equivalent to if error percentage is > 10%, then fail
+    validation().col("name").matches("Peter .*").errorThreshold(200)  //equivalent to if number of errors is > 200, then fail
+  )
+  .validationWait(waitCondition().pause(1));
+
+var conf = configuration().enableValidation(true);
+
+
+
+
val csvTxns = csv("transactions", "/tmp/csv", Map("header" -> "true"))
+  .validations(
+    validation.col("amount").lessThan(100),
+    validation.col("year").isEqual(2021).errorThreshold(0.1),  //equivalent to if error percentage is > 10%, then fail
+    validation.col("name").matches("Peter .*").errorThreshold(200)  //equivalent to if number of errors is > 200, then fail
+  )  
+  .validationWait(waitCondition.pause(1))
+
+val conf = configuration.enableValidation(true)
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  transactions:
+    options:
+      path: "/tmp/csv"
+    validations:
+      - expr: "amount < 100"
+      - expr: "year == 2021"
+        errorThreshold: 0.1   #equivalent to if error percentage is > 10%, then fail
+      - expr: "REGEXP_LIKE(name, 'Peter .*')"
+        errorThreshold: 200   #equivalent to if number of errors is > 200, then fail
+        description: "Should be lots of Peters"
+    waitCondition:
+      pauseInSeconds: 1
+
+
+
+
+

Wait Condition

+

Once data has been generated, you may want to wait for a certain condition to be met before starting the data +validations. This can be via:

+
    +
  • Pause for seconds
    • +
  • When file is available
    • +
  • Data exists
    • +
  • Webhook
    • +
+

Pause

+
+
+
+
var csvTxns = csv("transactions", "/tmp/csv", Map.of("header", "true"))
+  .validationWait(waitCondition().pause(1));
+
+
+
+
val csvTxns = csv("transactions", "/tmp/csv", Map("header" -> "true"))
+  .validationWait(waitCondition.pause(1))
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  transactions:
+    options:
+      path: "/tmp/csv"
+    waitCondition:
+      pauseInSeconds: 1
+
+
+
+
+

Data exists

+
+
+
+
var csvTxns = csv("transactions", "/tmp/csv", Map.of("header", "true"))
+  .validationWaitDataExists("updated_date > DATE('2023-01-01')");
+
+
+
+
val csvTxns = csv("transactions", "/tmp/csv", Map("header" -> "true"))
+  .validationWaitDataExists("updated_date > DATE('2023-01-01')")
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  transactions:
+    options:
+      path: "/tmp/csv"
+    waitCondition:
+      dataSourceName: "transactions"
+      options:
+        path: "/tmp/csv"
+      expr: "updated_date > DATE('2023-01-01')"
+
+
+
+
+

Webhook

+
+
+
+
var csvTxns = csv("transactions", "/tmp/csv", Map.of("header", "true"))
+  .validationWait(waitCondition().webhook("http://localhost:8080/finished")); //by default, GET request successful when 200 status code
+
+//or
+
+var csvTxnsWithStatusCodes = csv("transactions", "/tmp/csv", Map.of("header", "true"))
+  .validationWait(waitCondition().webhook("http://localhost:8080/finished", "GET", 200, 202));  //successful if 200 or 202 status code
+
+//or
+
+var csvTxnsWithExistingHttpConnection = csv("transactions", "/tmp/csv", Map.of("header", "true"))
+  .validationWait(waitCondition().webhook("my_http", "http://localhost:8080/finished"));  //use connection configuration from existing 'my_http' connection definition
+
+
+
+
val csvTxns = csv("transactions", "/tmp/csv", Map("header" -> "true"))
+  .validationWait(waitCondition.webhook("http://localhost:8080/finished"))  //by default, GET request successful when 200 status code
+
+//or
+
+val csvTxnsWithStatusCodes = csv("transactions", "/tmp/csv", Map("header" -> "true"))
+  .validationWait(waitCondition.webhook("http://localhost:8080/finished", "GET", 200, 202)) //successful if 200 or 202 status code
+
+//or
+
+val csvTxnsWithExistingHttpConnection = csv("transactions", "/tmp/csv", Map("header" -> "true"))
+  .validationWait(waitCondition.webhook("my_http", "http://localhost:8080/finished")) //use connection configuration from existing 'my_http' connection definition
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  transactions:
+    options:
+      path: "/tmp/csv"
+    waitCondition:
+      url: "http://localhost:8080/finished" #by default, GET request successful when 200 status code
+
+#or
+
+---
+name: "account_checks"
+dataSources:
+  transactions:
+    options:
+      path: "/tmp/csv"
+    waitCondition:
+      url: "http://localhost:8080/finished"
+      method: "GET"
+      statusCodes: [200, 202] #successful if 200 or 202 status code
+
+#or
+
+---
+name: "account_checks"
+dataSources:
+  transactions:
+    options:
+      path: "/tmp/csv"
+    waitCondition:
+      dataSourceName: "my_http" #use connection configuration from existing 'my_http' connection definition
+      url: "http://localhost:8080/finished"
+
+
+
+
+

File available

+
+
+
+
var csvTxns = csv("transactions", "/tmp/csv", Map.of("header", "true"))
+  .validationWait(waitCondition().file("/tmp/json"));
+
+
+
+
val csvTxns = csv("transactions", "/tmp/csv", Map.of("header", "true"))
+  .validationWait(waitCondition.file("/tmp/json"))
+
+
+
+
---
+name: "account_checks"
+dataSources:
+  transactions:
+    options:
+      path: "/tmp/csv"
+    waitCondition:
+      path: "/tmp/json"
+
+
+
+
+

Report

+

Once run, it will produce a report like this.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml new file mode 100644 index 00000000..ef6e3576 --- /dev/null +++ b/sitemap.xml @@ -0,0 +1,173 @@ + + + + https://data.catering/ + 2023-11-09 + daily + + + https://data.catering/about/ + 2023-11-09 + daily + + + https://data.catering/pricing/ + 2023-11-09 + daily + + + https://data.catering/get-started/docker/ + 2023-11-09 + daily + + + https://data.catering/legal/privacy-policy/ + 2023-11-09 + daily + + + https://data.catering/legal/terms-of-service/ + 2023-11-09 + daily + + + https://data.catering/setup/ + 2023-11-09 + daily + + + https://data.catering/setup/configuration/ + 2023-11-09 + daily + + + https://data.catering/setup/advanced/advanced/ + 2023-11-09 + daily + + + https://data.catering/setup/connection/connection/ + 2023-11-09 + daily + + + https://data.catering/setup/deployment/deployment/ + 2023-11-09 + daily + + + https://data.catering/setup/foreign-key/foreign-key/ + 2023-11-09 + daily + + + https://data.catering/setup/generator/count/ + 2023-11-09 + daily + + + https://data.catering/setup/generator/generator/ + 2023-11-09 + daily + + + https://data.catering/setup/generator/report/ + 2023-11-09 + daily + + + https://data.catering/setup/guide/ + 2023-11-09 + daily + + + https://data.catering/setup/guide/data-source/cassandra/ + 2023-11-09 + daily + + + https://data.catering/setup/guide/data-source/http/ + 2023-11-09 + daily + + + https://data.catering/setup/guide/data-source/kafka/ + 2023-11-09 + daily + + + https://data.catering/setup/guide/data-source/marquez-metadata-source/ + 2023-11-09 + daily + + + https://data.catering/setup/guide/data-source/open-metadata-source/ + 2023-11-09 + daily + + + https://data.catering/setup/guide/data-source/solace/ + 2023-11-09 + daily + + + https://data.catering/setup/guide/scenario/auto-generate-connection/ + 2023-11-09 + daily + + + https://data.catering/setup/guide/scenario/batch-and-event/ + 2023-11-09 + daily + + + https://data.catering/setup/guide/scenario/delete-generated-data/ + 2023-11-09 + daily + + + https://data.catering/setup/guide/scenario/first-data-generation/ + 2023-11-09 + daily + + + https://data.catering/setup/guide/scenario/records-per-column/ + 2023-11-09 + daily + + + https://data.catering/setup/validation/basic-validation/ + 2023-11-09 + daily + + + https://data.catering/setup/validation/group-by-validation/ + 2023-11-09 + daily + + + https://data.catering/setup/validation/validation/ + 2023-11-09 + daily + + + https://data.catering/use-case/business-value/ + 2023-11-09 + daily + + + https://data.catering/use-case/comparison/ + 2023-11-09 + daily + + + https://data.catering/use-case/roadmap/ + 2023-11-09 + daily + + + https://data.catering/use-case/use-case/ + 2023-11-09 + daily + + \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz new file mode 100644 index 0000000000000000000000000000000000000000..4687b7152965ca2b11e91a6640eb59d5781b5d32 GIT binary patch literal 524 zcmV+n0`vVJiwFofh)iVy|8r?{Wo=<_E_iKh0M(emlAACLhVT0n8Sajg?WNmE*jt~V zeE?w#;)$_Y$tI;wUz23BbWgo>M)<;SAgSK|>TC5{KOHi8#RxnG%+V>Py;z5(5nuU;slh?Y8%ZNNgAQY4*YE22xd}4^v+B&8Ox++ z6R6w64npsq{3Nh+szurj*G;NOdxxx!SmpB2g_4K2AM`w3H%I z+eqlTpw2k`rA5Ma7_d}Qq_P9DR7XD`Ka_A#!Xc7WJF~MW8Ew9!IA$u}MFY$bEWuiU z=j^qxo}oRj#@HU{E#q(1V}fOTCHQf`uvT`C9%R$9!2sl9a literal 0 HcmV?d00001 diff --git a/stylesheets/extra.css b/stylesheets/extra.css new file mode 100644 index 00000000..f8a1f93a --- /dev/null +++ b/stylesheets/extra.css @@ -0,0 +1,23 @@ +/* +#fbcccc -> hsl(0, 85%, 89%) +#36699F +#2d659e +#7786a7 +*/ +.center-content { + justify-content: center; + align-items: center; + display: flex; +} + +.content-spaced { + margin: 48px !important; +} + +.button-spaced { + margin: 32px; +} + +.red-cross { + color: #d9534f; +} diff --git a/use-case/business-value/index.html b/use-case/business-value/index.html new file mode 100644 index 00000000..7ec0baa3 --- /dev/null +++ b/use-case/business-value/index.html @@ -0,0 +1,2037 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Business Value - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Business Value

+

Below is a list of the business related benefits from using Data Caterer which may be applicable for your use case.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ProblemData Caterer SolutionResourcesEffects
Reliable test data creation- Profile existing data
- Create scenarios
- Generate data		Software Engineers, QA, TestersCost reduction in labor, more time spent on development, more bugs caught before production
Faster development cycles- Generate data in local, test, UAT, pre-prod
- Run different scenarios		Software Engineers, QA, TestersMore defects caught in lower environments, features pushed to production faster, common framework used across all environments
Data compliance- Profiling existing data
- Generate based on metadata
- No complex masking
- No production data used in lower environments		Audit and complianceNo chance for production data breaches
Storage costs- Delete generated data
- Test specific scenarios		InfrastructureLower data storage costs, less time spent on data management and clean up
Schema evolution- Create metadata from data sources
- Generate data based off fresh metadata		Software Engineers, QA, TestersLess time spent altering tests due to schema changes, ease of use between environments and application versions
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/use-case/comparison/index.html b/use-case/comparison/index.html new file mode 100644 index 00000000..12f7c832 --- /dev/null +++ b/use-case/comparison/index.html @@ -0,0 +1,2190 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Comparison - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Comparison to similar tools

+

I have tried to include all the companies found in the list +here from Mostly AI blog post and used information that is publicly +available.

+

The companies/products not shown below either have:

+
    +
  • a website with insufficient information about the technology side of data generation/validation
    • +
  • no/little documentation
    • +
  • don't have a free, no sign-up version of their app to use
    • +
+

Data Generation

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ToolDescriptionCostProsCons
Clearbox AIPython based data generation tool via MLUnclear✅ Python SDK
✅ UI interface
✅ Detect private data
✅ Report generation		 Batch data only
No data clean up
Limited/no documentation
Curiosity SoftwarePlatform solution for test data managementUnclear✅ Extensive documentation
✅ Generate data based off test cases
✅ UI interface
✅ Web/API/UI/mobile testing		 No quick start
No SDK
Many components that may not be required
No event generation support
DataCebo Synthetic Data VaultPython based data generation tool via MLUnclear✅ Python SDK
✅ Report generation
✅ Data quality checks
✅ Business logic constraints		 No data connection support
No data clean up
No foreign key support
DatafakerRealistic data generation libraryFree✅ SDK for many languages
✅ Simple, easy to use
✅ Extensible
✅ Open source
✅ Generate realistic values		 No data connection support
No data clean up
No validation
No foreign key support
DBLDatagenPython based data generation toolFree✅ Python SDK
✅ Open source
✅ Good documentation
✅ Customisable scenarios
✅ Customisable column generation
✅ Generate from existing data/schemas
✅ Plugin third-party libraries		 Limited support if issues
Code required
No data clean up
No data validation
GatlingHTTP API load testing toolFree (Open Source)
Gatling Enterprise, usage based, starts from €89 per month, 1 user, 6.25 hours of testing		✅ Kotlin, Java & Scala SDK
✅ Widely used
✅ Open source
✅ Clear documentation
✅ Extensive testing/validation support
✅ Customisable scenarios
✅ Report generation		 Only supports HTTP, JMS and JDBC
No data clean up
Data feeders not based off metadata
GretelPython based data generation tool via MLUsage based, starts from $295 per month, $2.20 per credit, assumed USD✅ CLI & Python SDK
✅ UI interface
✅ Training and re-use of models
✅ Detect private data
✅ Customisable scenarios		 Batch data only
No relationships between data sources
Only simple foreign key relations defined
No data clean up
Charge by usage
HowsoPython based data generation tool via MLUnclear✅ Python SDK
✅ Playground to try
✅ Open source library
✅ Customisable scenarios		 No support for data sources
No data validation
No data clean up
Mostly AIPython based data generation tool via MLUsage based, Enterprise 1 user, 100 columns, 100K rows $3,100 per month, assumed USD✅ Report generation
✅ Non-technical users can use UI
✅ Customisable scenarios		 Charge by usage
Batch data only
No data clean up
Confusing use of 'smart select' for multiple foreign keys
Limited custom column generation logic
Multiple deployment components
No SDK
OctopizePython based data generation tool via MLUnclear✅ Python & R SDK
✅ Report generation
✅ API for metadata
✅ Customisable scenarios		 Input data source is only CSV
Multiple manual steps before starting
Quickstart is not a quickstart
Documentation lacks code examples
SynthesizedPython based data generation tool via MLUnclear✅ CLI & Python SDK
✅ API for metadata
✅ IDE setup
✅ Data quality checks		 Not sure what is SDK & TDK
Charge by usage
No report of what was generated
No relationships between data sources
TonicPlatform solution for generating dataUnclear✅ UI interface
✅ Good documentation
✅ Detect private data
✅ Support for encrypted columns
✅ Report generation
✅ Alerting		 Batch data only
Multiple deployment components
No relationships between data sources
No data validation
No data clean up
No SDK (only API)
Difficult to embed complex business logic
YDataPython based data generation tool via ML. Platform solution as wellUnclear✅ Python SDK
✅ Open source
✅ Detect private data
✅ Compare datasets
✅ Report generation		 No data connection support
Batch data only
No data clean up
Separate data generation and data validation
No foreign key support
+

Use of ML models

+

You may notice that the majority of data generators use machine learning (ML) models to learn from your existing +datasets to generate new data. Below are some pros and cons to the approach.

+

Pros

+
    +
  • Simple setup
    • +
  • Ability to reproduce complex logic
    • +
  • Flexible to accept all types of data
    • +
+

Cons

+
    +
  • Long time for model learning
    • +
  • Black box of logic
    • +
  • Maintain, store and update of ML models
    • +
  • Restriction on input data lengths
    • +
  • May not maintain referential integrity
    • +
  • Require deeper understanding of ML models for fine-tuning
    • +
  • Accuracy may be worse than non-ML models
    • +
+ + + + + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/use-case/roadmap/index.html b/use-case/roadmap/index.html new file mode 100644 index 00000000..8a0c6288 --- /dev/null +++ b/use-case/roadmap/index.html @@ -0,0 +1,2081 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Roadmap - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Roadmap

+
    +
  • Support for other data sources
      +
    • GCP and Azure related data services (✅ cloud storage)
      • +
    • Deltalake
      • +
    • RabbitMQ
      • +
    • ActiveMQ
      • +
    • MongoDB
      • +
    • Airflow
      • +
    • DBT
      • +
    +
    • +
  • Further support for metadata discovery
      +
    • ✅ HTTP (OpenAPI spec)
      • +
    • JMS
      • +
    • Read from samples
      • +
    +
    • +
  • ✅ API for developers and testers
      +
    • ✅ Scala
      • +
    • ✅ Java
      • +
    +
    • +
  • UI for metadata and data generation
    • +
  • ✅ Report for data generated and validation rules
    • +
  • Metadata stored in database
    • +
  • Integration with existing metadata services (i.e. Amundsen, Datahub, Schema Registry, DBT)
      +
    • Populate metadata back to metadata services
      • +
    • ✅ OpenLineage metadata (Marquez)
      • +
    • ✅ OpenMetadata
      • +
    +
    • +
  • Integration with existing data validations +
    • +
  • ✅ Suggest data validations
    • +
  • Data dictionary
      +
    • Business definitions of fields that can be referenced for metadata across all data sources
      • +
    +
    • +
  • ✅ Verification rules after data generation
    • +
  • ✅ Validation waiting conditions
      +
    • ✅ Webhook
      • +
    • ✅ File exists
      • +
    • ✅ Data exists via SQL expression
      • +
    • ✅ Pause
      • +
    +
    • +
  • Extend validation types
      +
    • ✅ Aggregates (sum of amount per account is > 500)
      • +
    • Ordering (transactions are ordered by date)
      • +
    • Relationship (at least one account entry in history table per account in accounts table)
      • +
    • Data profile (how close the generated data profile is compared to the expected data profile)
      • +
    +
    • +
  • Extend count
      +
    • Cover all possible cases (i.e. record for each combination of oneOf values, positive/negative values etc.)
      • +
    • Similar to edge cases
      • +
    +
    • +
  • Alerting
      +
    • Slack
      • +
    • Email
      • +
    +
    • +
  • Overriding tasks
      +
    • Can customise tasks without copying whole schema definitions
      • +
    • Easier to create scenarios
      • +
    +
    • +
  • Gradle plugin
    • +
  • Metadata improvements
      +
    • PII detection (can integrate with Presidio)
      • +
    • Relationship detection across data sources
      • +
    • SQL generation
      • +
    • Ordering information
      • +
    +
    • +
  • Code generation
    • +
  • Schema generation from Scala/Java class
    • +
  • Ordering within data sources that support order for insertion
    • +
  • Clean up data in consumer data sinks
    • +
  • ✅ Trial app to try out all features
    • +
+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/use-case/use-case/index.html b/use-case/use-case/index.html new file mode 100644 index 00000000..47d42342 --- /dev/null +++ b/use-case/use-case/index.html @@ -0,0 +1,2161 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + Use cases - Data Catering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + +
+ + +
+ +
+ + + + + + + + + +
+
+ + + +
+
+
+ + + + + + + + + +
+
+
+ + + + +
+ +
+ + + + + + + +

Use cases

+

Replicate production in lower environment

+

Having a stable and reliable test environment is a challenge for a number of companies, especially where teams are +asynchronously deploying and testing changes at faster rates. Data Caterer can help alleviate these issues by doing +the following:

+
    +
  1. Generates data with the latest schema changes and production like field values
    2. +
  2. Run as a job on a daily/regular basis to replicate production traffic or data flows
    3. +
  3. Validate data to ensure your system runs as expected
    4. +
  4. Clean up data to avoid build up of generated data
    5. +
+

Replicate production flow

+

Local development

+

Similar to the above, being able to replicate production like data in your local environment can be key to developing +more reliable code as you can test directly against data in your local computer. This has a number of benefits +including:

+
    +
  1. Fewer assumptions or ambiguities when the developer codes
    2. +
  2. Direct feedback loop in local computer rather than waiting for test environment for more reliable test data
    3. +
  3. No domain expertise required to understand the data
    4. +
  4. Easy for new developers to be onboarded and developing/testing code for jobs/services
    5. +
+

System/integration testing

+

When working with third-party, external or internal data providers, it can be difficult to have all setup ready to +produce reliable data that abides by relationship contracts between each of the systems. You have to rely on these data +providers in order for you to run your tests which may not align to their priorities. With Data Caterer, you can +generate the same data that they would produce, along with maintaining referential integrity across the data providers, +so that you can run your tests without relying on their systems being up and reliable in their corresponding +lower environments.

+

Scenario testing

+

If you want to set up particular data scenarios, you can customise the generated data to fit your scenario. Once the +data gets generated and is consumed, you can also run validations to ensure your system has consumed the data correctly. +These scenarios can be put together from existing tasks or data sources can be enabled/disabled based on your +requirement. Built into Data Caterer and controlled via feature flags, is the ability to test edge cases based on the +data type of the fields used for data generation (enableEdgeCases flag within <field>.generator.options, see more +here).

+

Data debugging

+

When data related issues occur in production, it may be difficult to replicate in a lower or local environment. It could +be related to specific fields not containing expected results, size of data is too large or missing corresponding +referenced data. This becomes key to resolving the issue as you can directly code against the exact data scenario and +have confidence that your code changes will fix the problem. Data Caterer can be used to generate the appropriate data +in whichever environment you want to test your changes against.

+

Data profiling

+

When using Data Caterer with the feature flag enableGeneratePlanAndTasks enabled +(see here), metadata relating all the fields defined in the data sources you have +configured will be generated via data profiling. You can run this as a standalone job (can disable enableGenerateData) +so that you can focus on the profile of the data you are utilising. This can be run against your production data sources +to ensure the metadata can be used to accurately generate data in other environments. This is a key feature of Data +Caterer as no direct production connections need to be maintained to generate data in other environments (which can +lead to serious concerns about data security as seen here).

+

Schema gathering

+

When using Data Caterer with the feature flag enableGeneratePlanAndTasks enabled +(see here), all schemas of the data sources defined will be tracked in a common format (as +tasks). This data, along with the data profiling metadata, could then feed back into your schema registries to help keep +them up to date with your system.

+ + + + + + + + + + + + + + + +
+
+ + + + + +
+ + + +
+ + + +
+
+
+
+ + + + + + + + + + + + + + + \ No newline at end of file