\documentclass[10pt,a4paper]{article} % Packages \usepackage{fancyhdr} % For header and footer \usepackage{multicol} % Allows multicols in tables \usepackage{tabularx} % Intelligent column widths \usepackage{tabulary} % Used in header and footer \usepackage{hhline} % Border under tables \usepackage{graphicx} % For images \usepackage{xcolor} % For hex colours %\usepackage[utf8x]{inputenc} % For unicode character support \usepackage[T1]{fontenc} % Without this we get weird character replacements \usepackage{colortbl} % For coloured tables \usepackage{setspace} % For line height \usepackage{lastpage} % Needed for total page number \usepackage{seqsplit} % Splits long words. %\usepackage{opensans} % Can't make this work so far. Shame. Would be lovely. \usepackage[normalem]{ulem} % For underlining links % Most of the following are not required for the majority % of cheat sheets but are needed for some symbol support. \usepackage{amsmath} % Symbols \usepackage{MnSymbol} % Symbols \usepackage{wasysym} % Symbols %\usepackage[english,german,french,spanish,italian]{babel} % Languages % Document Info \author{erezsh} \pdfinfo{ /Title (lark.pdf) /Creator (Cheatography) /Author (erezsh) /Subject (Lark Cheat Sheet) } % Lengths and widths \addtolength{\textwidth}{6cm} \addtolength{\textheight}{-1cm} \addtolength{\hoffset}{-3cm} \addtolength{\voffset}{-2cm} \setlength{\tabcolsep}{0.2cm} % Space between columns \setlength{\headsep}{-12pt} % Reduce space between header and content \setlength{\headheight}{85pt} % If less, LaTeX automatically increases it \renewcommand{\footrulewidth}{0pt} % Remove footer line \renewcommand{\headrulewidth}{0pt} % Remove header line \renewcommand{\seqinsert}{\ifmmode\allowbreak\else\-\fi} % Hyphens in seqsplit % This two commands together give roughly % the right line height in the tables \renewcommand{\arraystretch}{1.3} \onehalfspacing % Commands \newcommand{\SetRowColor}[1]{\noalign{\gdef\RowColorName{#1}}\rowcolor{\RowColorName}} % Shortcut for row colour \newcommand{\mymulticolumn}[3]{\multicolumn{#1}{>{\columncolor{\RowColorName}}#2}{#3}} % For coloured multi-cols \newcolumntype{x}[1]{>{\raggedright}p{#1}} % New column types for ragged-right paragraph columns \newcommand{\tn}{\tabularnewline} % Required as custom column type in use % Font and Colours \definecolor{HeadBackground}{HTML}{333333} \definecolor{FootBackground}{HTML}{666666} \definecolor{TextColor}{HTML}{333333} \definecolor{DarkBackground}{HTML}{3360A3} \definecolor{LightBackground}{HTML}{F2F5F9} \renewcommand{\familydefault}{\sfdefault} \color{TextColor} % Header and Footer \pagestyle{fancy} \fancyhead{} % Set header to blank \fancyfoot{} % Set footer to blank \fancyhead[L]{ \noindent \begin{multicols}{3} \begin{tabulary}{5.8cm}{C} \SetRowColor{DarkBackground} \vspace{-7pt} {\parbox{\dimexpr\textwidth-2\fboxsep\relax}{\noindent \hspace*{-6pt}\includegraphics[width=5.8cm]{/web/www.cheatography.com/public/images/cheatography_logo.pdf}} } \end{tabulary} \columnbreak \begin{tabulary}{11cm}{L} \vspace{-2pt}\large{\bf{\textcolor{DarkBackground}{\textrm{Lark Cheat Sheet}}}} \\ \normalsize{by \textcolor{DarkBackground}{erezsh} via \textcolor{DarkBackground}{\uline{cheatography.com/61630/cs/15903/}}} \end{tabulary} \end{multicols}} \fancyfoot[L]{ \footnotesize \noindent \begin{multicols}{3} \begin{tabulary}{5.8cm}{LL} \SetRowColor{FootBackground} \mymulticolumn{2}{p{5.377cm}}{\bf\textcolor{white}{Cheatographer}} \\ \vspace{-2pt}erezsh \\ \uline{cheatography.com/erezsh} \\ \end{tabulary} \vfill \columnbreak \begin{tabulary}{5.8cm}{L} \SetRowColor{FootBackground} \mymulticolumn{1}{p{5.377cm}}{\bf\textcolor{white}{Cheat Sheet}} \\ \vspace{-2pt}Published 26th May, 2018.\\ Updated 29th September, 2020.\\ Page {\thepage} of \pageref{LastPage}. \end{tabulary} \vfill \columnbreak \begin{tabulary}{5.8cm}{L} \SetRowColor{FootBackground} \mymulticolumn{1}{p{5.377cm}}{\bf\textcolor{white}{Sponsor}} \\ \SetRowColor{white} \vspace{-5pt} %\includegraphics[width=48px,height=48px]{dave.jpeg} Measure your website readability!\\ www.readability-score.com \end{tabulary} \end{multicols}} \begin{document} \raggedright \raggedcolumns % Set font size to small. Switch to any value % from this page to resize cheat sheet text: % www.emerson.emory.edu/services/latex/latex_169.html \footnotesize % Small font. \begin{multicols*}{2} \begin{tabularx}{8.4cm}{x{3.6 cm} x{4.4 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{8.4cm}}{\bf\textcolor{white}{Lark Options}} \tn % Row 0 \SetRowColor{LightBackground} `parser="earley"` & {\bf{Earley}} - default \tn % Row Count 1 (+ 1) % Row 1 \SetRowColor{white} `parser="lalr"` & {\bf{LALR(1)}} \tn % Row Count 2 (+ 1) % Row 2 \SetRowColor{LightBackground} `debug=True` & Enable debug prints \tn % Row Count 3 (+ 1) % Row 3 \SetRowColor{white} \{\{nobreak\}\}`lexer="standard"` & Revert to simple lexer \tn % Row Count 5 (+ 2) % Row 4 \SetRowColor{LightBackground} \{\{nobreak\}\}`ambiguity='explicit'` & Return all derivations for Earley \tn % Row Count 7 (+ 2) % Row 5 \SetRowColor{white} `start="foo"` & Set starting rule \tn % Row Count 8 (+ 1) % Row 6 \SetRowColor{LightBackground} `cache=True` & Enable grammar caching \tn % Row Count 9 (+ 1) % Row 7 \SetRowColor{white} `transformer=...` & Apply transformer to tree (for LALR) \tn % Row Count 11 (+ 2) % Row 8 \SetRowColor{LightBackground} \{\{nobreak\}\}`propagate\_positions` & Fill tree instances with line number information \tn % Row Count 14 (+ 3) % Row 9 \SetRowColor{white} \{\{nobreak\}\}`maybe\_placeholders` & `{[}{]}` returns `None` when not matched \tn % Row Count 16 (+ 2) % Row 10 \SetRowColor{LightBackground} \seqsplit{`keep\_all\_tokens=True`} & Don't remove unnamed terminals \tn % Row Count 18 (+ 2) % Row 11 \SetRowColor{white} `postlex` & Provide a wrapper for the lexer \tn % Row Count 20 (+ 2) % Row 12 \SetRowColor{LightBackground} `tree\_class` & Provide an alternative for `Tree` \tn % Row Count 22 (+ 2) % Row 13 \SetRowColor{white} `regex=True` & Use the `regex` module \tn % Row Count 23 (+ 1) \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{x{4 cm} x{4 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{8.4cm}}{\bf\textcolor{white}{Tree Reference}} \tn % Row 0 \SetRowColor{LightBackground} `tree.data` & Rule name \tn % Row Count 1 (+ 1) % Row 1 \SetRowColor{white} `tree.children` & Rule matches \tn % Row Count 2 (+ 1) % Row 2 \SetRowColor{LightBackground} `tree.meta` & Positional information, if enabled \tn % Row Count 4 (+ 2) % Row 3 \SetRowColor{white} \mymulticolumn{2}{x{8.4cm}}{`print(tree.pretty())`} \tn % Row Count 5 (+ 1) % Row 4 \SetRowColor{LightBackground} \seqsplit{`tree.iter\_subtrees()`} & Iterate all subtrees \tn % Row Count 7 (+ 2) % Row 5 \SetRowColor{white} \{\{nobreak\}\}`tree.find\_data("foo")` & Find by rule \tn % Row Count 9 (+ 2) % Row 6 \SetRowColor{LightBackground} \seqsplit{`tree.find\_pred(...)`} & Find by predicate \tn % Row Count 11 (+ 2) % Row 7 \SetRowColor{white} \mymulticolumn{2}{x{8.4cm}}{`tree1 == tree2`} \tn % Row Count 12 (+ 1) \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{x{4.08 cm} x{3.92 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{8.4cm}}{\bf\textcolor{white}{Token Reference}} \tn % Row 0 \SetRowColor{LightBackground} `token.type` & Terminal name \tn % Row Count 1 (+ 1) % Row 1 \SetRowColor{white} `token.value` & Matched text \tn % Row Count 2 (+ 1) % Row 2 \SetRowColor{LightBackground} \seqsplit{`token.pos\_in\_stream`} & Index in source text \tn % Row Count 4 (+ 2) % Row 3 \SetRowColor{white} \mymulticolumn{2}{x{8.4cm}}{`token.line`} \tn % Row Count 5 (+ 1) % Row 4 \SetRowColor{LightBackground} \mymulticolumn{2}{x{8.4cm}}{`token.column`} \tn % Row Count 6 (+ 1) % Row 5 \SetRowColor{white} \mymulticolumn{2}{x{8.4cm}}{`token.end\_line`} \tn % Row Count 7 (+ 1) % Row 6 \SetRowColor{LightBackground} \mymulticolumn{2}{x{8.4cm}}{\{\{nobreak\}\}`token.end\_column`} \tn % Row Count 8 (+ 1) % Row 7 \SetRowColor{white} \mymulticolumn{2}{x{8.4cm}}{`token.end\_pos`} \tn % Row Count 9 (+ 1) % Row 8 \SetRowColor{LightBackground} \mymulticolumn{2}{x{8.4cm}}{`len(token)`} \tn % Row Count 10 (+ 1) \hhline{>{\arrayrulecolor{DarkBackground}}--} \SetRowColor{LightBackground} \mymulticolumn{2}{x{8.4cm}}{Tokens inherit from `str`, so all string operations are valid (such as `token.upper()`).} \tn \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{x{3.44 cm} x{4.56 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{8.4cm}}{\bf\textcolor{white}{Grammar Definitions}} \tn % Row 0 \SetRowColor{LightBackground} `rule: ...` & Define a rule \tn % Row Count 1 (+ 1) % Row 1 \SetRowColor{white} `TERM: ...` & Define a terminal \tn % Row Count 2 (+ 1) % Row 2 \SetRowColor{LightBackground} `rule.n: ...` & Rule with priority n \tn % Row Count 3 (+ 1) % Row 3 \SetRowColor{white} `TERM.n: ...` & Terminal with priority n \tn % Row Count 5 (+ 2) % Row 4 \SetRowColor{LightBackground} `// text` & Comment \tn % Row Count 6 (+ 1) % Row 5 \SetRowColor{white} `\%ignore ...` & Ignore terminal in input \tn % Row Count 8 (+ 2) % Row 6 \SetRowColor{LightBackground} `\%import ...` & Import terminal from file \tn % Row Count 10 (+ 2) % Row 7 \SetRowColor{white} \{\{nobreak\}\}`\%declare TERM` & Declare a terminal without a pattern (used for postlex) \tn % Row Count 13 (+ 3) % Row 8 \SetRowColor{LightBackground} \{\{nobreak\}\}`t\{p1, p2\}: ...` & Define template \tn % Row Count 15 (+ 2) % Row 9 \SetRowColor{white} \{\{nobreak\}\}`rule: t\{foo, bar\}` & Use template \tn % Row Count 17 (+ 2) \hhline{>{\arrayrulecolor{DarkBackground}}--} \SetRowColor{LightBackground} \mymulticolumn{2}{x{8.4cm}}{{\bf{Rules}} consist of values, other rules and terminals. \newline {\bf{Terminals}} only consist of values and other terminals.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{x{2.08 cm} x{5.92 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{8.4cm}}{\bf\textcolor{white}{Grammar Patterns}} \tn % Row 0 \SetRowColor{LightBackground} `foo bar` & Match sequence \tn % Row Count 1 (+ 1) % Row 1 \SetRowColor{white} `(foo bar)` & Group together (for operations) \tn % Row Count 3 (+ 2) % Row 2 \SetRowColor{LightBackground} `foo | bar` & Match one or the other \tn % Row Count 5 (+ 2) % Row 3 \SetRowColor{white} `foo?` & Match 0 or 1 instances \tn % Row Count 6 (+ 1) % Row 4 \SetRowColor{LightBackground} `{[}foo bar{]}` & Match 0 or 1 instances \tn % Row Count 8 (+ 2) % Row 5 \SetRowColor{white} `foo*` & Match 0 or more instances \tn % Row Count 9 (+ 1) % Row 6 \SetRowColor{LightBackground} `foo+` & Match 1 or more instances \tn % Row Count 10 (+ 1) % Row 7 \SetRowColor{white} `foo\textasciitilde{}3` & Match exactly 3 instances \tn % Row Count 11 (+ 1) % Row 8 \SetRowColor{LightBackground} `foo\textasciitilde{}3..5` & Match between 3 to 5 instances \tn % Row Count 13 (+ 2) \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{x{2.32 cm} x{5.68 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{8.4cm}}{\bf\textcolor{white}{Terminal Atoms}} \tn % Row 0 \SetRowColor{LightBackground} `"string"` & String to match \tn % Row Count 1 (+ 1) % Row 1 \SetRowColor{white} \seqsplit{`"string"i`} & Case-insensitive string \tn % Row Count 2 (+ 1) % Row 2 \SetRowColor{LightBackground} `/regexp/` & Regular Expression \tn % Row Count 3 (+ 1) % Row 3 \SetRowColor{white} \seqsplit{`/re/imslux`} & Regular Expression with flags \tn % Row Count 5 (+ 2) % Row 4 \SetRowColor{LightBackground} `"a".."z"` & Literal range \tn % Row Count 6 (+ 1) \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{x{4.4 cm} x{3.6 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{8.4cm}}{\bf\textcolor{white}{Tree Shaping}} \tn % Row 0 \SetRowColor{LightBackground} `rule: "foo" BAR` & "foo" will be filtered out \tn % Row Count 2 (+ 2) % Row 1 \SetRowColor{white} `!rule: "foo" BAR` & "foo" will be kept \tn % Row Count 3 (+ 1) % Row 2 \SetRowColor{LightBackground} `rule: /foo/ BAR` & /foo/ will be kept \tn % Row Count 4 (+ 1) % Row 3 \SetRowColor{white} `\_TERM` & Filter out this terminal \tn % Row Count 6 (+ 2) % Row 4 \SetRowColor{LightBackground} `\_rule` & Always inline this rule \tn % Row Count 8 (+ 2) % Row 5 \SetRowColor{white} `?rule: ...` & Inline if matched 1 child \tn % Row Count 10 (+ 2) % Row 6 \SetRowColor{LightBackground} \{\{nobreak\}\}`foo bar -\textgreater{} new\_name` & Rename this derivation \tn % Row Count 12 (+ 2) \hhline{>{\arrayrulecolor{DarkBackground}}--} \SetRowColor{LightBackground} \mymulticolumn{2}{x{8.4cm}}{{\bf{Rules}} are a branch (node) in the resulting tree, and its children are its matches, in the order of matching. \newline {\bf{Terminals}} (tokens) are always values in the tree, never branches. \newline {\bf{Inlining rules}} means removing their branch and replacing it with their children.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{Examples}} \tn \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{// Define template for comma-separated list \newline cs\_list\{item\}: item ("," item){\emph{ \newline \newline // Use template to make a list of numbers \newline number\_list: cs\_list\{ number \} \newline \newline // Example of a terminal for a Python comment \newline PY\_COMMENT: /\#{[}\textasciicircum{}\textbackslash{}n{]}}}/ \newline \newline // Example of a terminal for C comment \newline C\_COMMENT: "/{\emph{" /.}}?/s "*/"} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} % That's all folks \end{multicols*} \end{document}