#!/usr/bin/env node // Usage: node parse.js // // Script that creates index.html out of web/template.html and README.md. // It is written in JS because this code used to be executed on the client side. // To install the Node.js and npm run: // $ sudo apt install nodejs npm # On macOS use `brew install ...` instead. // To install dependencies globally, run: // $ npm install -g jsdom jquery showdown highlightjs@9.12.0 // If running on macOS and modules can't be found after installation add: // export NODE_PATH=/usr/local/lib/node_modules // to the ~/.bash_profile or ~/.bashrc file and run '$ bash'. // To avoid problems with permissions and path variables, install modules // into project's directory using: // $ npm install jsdom jquery showdown highlightjs@9.12.0 // It is also advisable to add a script into .git/hooks directory, that will run // this script before every commit. It should be named 'pre-commit' and it should // contain the following line: `./parse.js`. const fs = require('fs'); const jsdom = require('jsdom'); const showdown = require('showdown'); const hljs = require('highlightjs'); const TOC = '
' + '

Contents

\n' + '
ToC = {\n' +
  '    \'1. Collections\': [List, Dictionary, Set, Tuple, Range, Enumerate, Iterator, Generator],\n' +
  '    \'2. Types\':       [Type, String, Regular_Exp, Format, Numbers, Combinatorics, Datetime],\n' +
  '    \'3. Syntax\':      [Args, Inline, Closure, Decorator, Class, Duck_Type, Enum, Exception],\n' +
  '    \'4. System\':      [Exit, Print, Input, Command_Line_Arguments, Open, Path, OS_Commands],\n' +
  '    \'5. Data\':        [JSON, Pickle, CSV, SQLite, Bytes, Struct, Array, Memory_View, Deque],\n' +
  '    \'6. Advanced\':    [Threading, Operator, Introspection, Metaprograming, Eval, Coroutine],\n' +
  '    \'7. Libraries\':   [Progress_Bar, Plot, Table, Curses, Logging, Scraping, Web, Profile,\n' +
  '                       NumPy, Image, Audio, Games, Data]\n' +
  '}\n' +
  '
\n'; const LRU_CACHE = 'from functools import lru_cache\n' + '\n' + '@lru_cache(maxsize=None)\n' + 'def fib(n):\n' + ' return n if n < 2 else fib(n-2) + fib(n-1)\n'; const CONSTRUCTOR_OVERLOADING = 'class <name>:\n' + ' def __init__(self, a=None):\n' + ' self.a = a\n'; const DATACLASS = 'from dataclasses import make_dataclass\n' + '<class> = make_dataclass(\'<class_name>\', <coll_of_attribute_names>)\n' + '<class> = make_dataclass(\'<class_name>\', <coll_of_tuples>)\n' + '<tuple> = (\'<attr_name>\', <type> [, <default_value>])'; const SHUTIL_COPY = 'shutil.copy(from, to) # Copies the file. \'to\' can exist or be a dir.\n' + 'shutil.copytree(from, to) # Copies the directory. \'to\' must not exist.\n'; const OS_RENAME = 'os.rename(from, to) # Renames/moves the file or directory.\n' + 'os.replace(from, to) # Same, but overwrites \'to\' if it exists.\n'; const TYPE = '<class> = type(\'<class_name>\', <parents_tuple>, <attributes_dict>)'; const EVAL = '>>> from ast import literal_eval\n' + '>>> literal_eval(\'[1, 2, 3]\')\n' + '[1, 2, 3]\n' + '>>> literal_eval(\'1 + 2\')\n' + 'ValueError: malformed node or string\n'; const PROGRESS_BAR = '# $ pip3 install tqdm\n' + '>>> from tqdm import tqdm\n' + '>>> from time import sleep\n' + '>>> for el in tqdm([1, 2, 3], desc=\'Processing\'):\n' + '... sleep(1)\n' + 'Processing: 100%|████████████████████| 3/3 [00:03<00:00, 1.00s/it]\n'; const PYINSTALLER = '$ pip3 install pyinstaller\n' + '$ pyinstaller script.py # Compiles into \'./dist/script\' directory.\n' + '$ pyinstaller script.py --onefile # Compiles into \'./dist/script\' console app.\n' + '$ pyinstaller script.py --windowed # Compiles into \'./dist/script\' windowed app.\n' + '$ pyinstaller script.py --add-data \'<path>:.\' # Adds file to the root of the executable.\n'; const INDEX = '
  • Only available in the PDF.
  • \n' + '
  • Ctrl+F / ⌘F is usually sufficient.
  • \n' + '
  • Searching \'#<title>\' will limit the search to the titles.
  • \n'; const DIAGRAM_1_A = '+------------------+------------+------------+------------+\n' + '| | Sequence | Collection | Iterable |\n' + '+------------------+------------+------------+------------+\n'; const DIAGRAM_1_B = '┏━━━━━━━━━━━━━━━━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━┓\n' + '┃ │ Sequence │ Collection │ Iterable ┃\n' + '┠──────────────────┼────────────┼────────────┼────────────┨\n' + '┃ list, range, str │ ✓ │ ✓ │ ✓ ┃\n' + '┃ dict, set │ │ ✓ │ ✓ ┃\n' + '┃ iter │ │ │ ✓ ┃\n' + '┗━━━━━━━━━━━━━━━━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━┛\n'; const DIAGRAM_2_A = '+--------------------+----------+----------+----------+----------+----------+\n' + '| | Integral | Rational | Real | Complex | Number |\n' + '+--------------------+----------+----------+----------+----------+----------+\n'; const DIAGRAM_2_B = '┏━━━━━━━━━━━━━━━━━━━━┯━━━━━━━━━━┯━━━━━━━━━━┯━━━━━━━━━━┯━━━━━━━━━━┯━━━━━━━━━━┓\n' + '┃ │ Integral │ Rational │ Real │ Complex │ Number ┃\n' + '┠────────────────────┼──────────┼──────────┼──────────┼──────────┼──────────┨\n' + '┃ int │ ✓ │ ✓ │ ✓ │ ✓ │ ✓ ┃\n' + '┃ fractions.Fraction │ │ ✓ │ ✓ │ ✓ │ ✓ ┃\n' + '┃ float │ │ │ ✓ │ ✓ │ ✓ ┃\n' + '┃ complex │ │ │ │ ✓ │ ✓ ┃\n' + '┃ decimal.Decimal │ │ │ │ │ ✓ ┃\n' + '┗━━━━━━━━━━━━━━━━━━━━┷━━━━━━━━━━┷━━━━━━━━━━┷━━━━━━━━━━┷━━━━━━━━━━┷━━━━━━━━━━┛\n'; const DIAGRAM_3_A = '+---------------+----------+----------+----------+----------+----------+\n'; const DIAGRAM_3_B = '┏━━━━━━━━━━━━━━━┯━━━━━━━━━━┯━━━━━━━━━━┯━━━━━━━━━━┯━━━━━━━━━━┯━━━━━━━━━━┓\n' + '┃ │ [ !#$%…] │ [a-zA-Z] │ [¼½¾] │ [²³¹] │ [0-9] ┃\n' + '┠───────────────┼──────────┼──────────┼──────────┼──────────┼──────────┨\n' + '┃ isprintable() │ ✓ │ ✓ │ ✓ │ ✓ │ ✓ ┃\n' + '┃ isalnum() │ │ ✓ │ ✓ │ ✓ │ ✓ ┃\n' + '┃ isnumeric() │ │ │ ✓ │ ✓ │ ✓ ┃\n' + '┃ isdigit() │ │ │ │ ✓ │ ✓ ┃\n' + '┃ isdecimal() │ │ │ │ │ ✓ ┃\n' + '┗━━━━━━━━━━━━━━━┷━━━━━━━━━━┷━━━━━━━━━━┷━━━━━━━━━━┷━━━━━━━━━━┷━━━━━━━━━━┛\n'; const DIAGRAM_4_A = "+--------------+----------------+----------------+----------------+----------------+\n" + "| | {} | {:f} | {:e} | {:%} |\n" + "+--------------+----------------+----------------+----------------+----------------+\n"; const DIAGRAM_4_B = "┏━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━┓\n" + "┃ │ {<float>} │ {<float>:f} │ {<float>:e} │ {<float>:%} ┃\n" + "┠──────────────┼────────────────┼────────────────┼────────────────┼────────────────┨\n" + "┃ 0.000056789 │ '5.6789e-05' │ '0.000057' │ '5.678900e-05' │ '0.005679%' ┃\n" + "┃ 0.00056789 │ '0.00056789' │ '0.000568' │ '5.678900e-04' │ '0.056789%' ┃\n" + "┃ 0.0056789 │ '0.0056789' │ '0.005679' │ '5.678900e-03' │ '0.567890%' ┃\n" + "┃ 0.056789 │ '0.056789' │ '0.056789' │ '5.678900e-02' │ '5.678900%' ┃\n" + "┃ 0.56789 │ '0.56789' │ '0.567890' │ '5.678900e-01' │ '56.789000%' ┃\n" + "┃ 5.6789 │ '5.6789' │ '5.678900' │ '5.678900e+00' │ '567.890000%' ┃\n" + "┃ 56.789 │ '56.789' │ '56.789000' │ '5.678900e+01' │ '5678.900000%' ┃\n" + "┗━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━┛\n"; const DIAGRAM_5_A = "+--------------+----------------+----------------+----------------+----------------+\n" + "| | {:.2} | {:.2f} | {:.2e} | {:.2%} |\n" + "+--------------+----------------+----------------+----------------+----------------+\n"; const DIAGRAM_5_B = "┏━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━┓\n" + "┃ │ {<float>:.2} │ {<float>:.2f} │ {<float>:.2e} │ {<float>:.2%} ┃\n" + "┠──────────────┼────────────────┼────────────────┼────────────────┼────────────────┨\n" + "┃ 0.000056789 │ '5.7e-05' │ '0.00' │ '5.68e-05' │ '0.01%' ┃\n" + "┃ 0.00056789 │ '0.00057' │ '0.00' │ '5.68e-04' │ '0.06%' ┃\n" + "┃ 0.0056789 │ '0.0057' │ '0.01' │ '5.68e-03' │ '0.57%' ┃\n" + "┃ 0.056789 │ '0.057' │ '0.06' │ '5.68e-02' │ '5.68%' ┃\n" + "┃ 0.56789 │ '0.57' │ '0.57' │ '5.68e-01' │ '56.79%' ┃\n" + "┃ 5.6789 │ '5.7' │ '5.68' │ '5.68e+00' │ '567.89%' ┃\n" + "┃ 56.789 │ '5.7e+01' │ '56.79' │ '5.68e+01' │ '5678.90%' ┃\n" + "┗━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━┛\n"; const DIAGRAM_6_A = '+------------+------------+------------+------------+--------------+\n' + '| | Iterable | Collection | Sequence | abc.Sequence |\n' + '+------------+------------+------------+------------+--------------+\n'; const DIAGRAM_6_B = '┏━━━━━━━━━━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━━━┓\n' + '┃ │ Iterable │ Collection │ Sequence │ abc.Sequence ┃\n' + '┠────────────┼────────────┼────────────┼────────────┼──────────────┨\n' + '┃ iter() │ ! │ ! │ ✓ │ ✓ ┃\n' + '┃ contains() │ ✓ │ ✓ │ ✓ │ ✓ ┃\n' + '┃ len() │ │ ! │ ! │ ! ┃\n' + '┃ getitem() │ │ │ ! │ ! ┃\n' + '┃ reversed() │ │ │ ✓ │ ✓ ┃\n' + '┃ index() │ │ │ │ ✓ ┃\n' + '┃ count() │ │ │ │ ✓ ┃\n' + '┗━━━━━━━━━━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━━━┛\n'; const DIAGRAM_7_A = 'BaseException\n' + ' +-- SystemExit'; const DIAGRAM_7_B = "BaseException\n" + " ├── SystemExit # Raised by the sys.exit() function.\n" + " ├── KeyboardInterrupt # Raised when the user hits the interrupt key (ctrl-c).\n" + " └── Exception # User-defined exceptions should be derived from this class.\n" + " ├── ArithmeticError # Base class for arithmetic errors.\n" + " │ └── ZeroDivisionError # Raised when dividing by zero.\n" + " ├── AttributeError # Raised when an attribute is missing.\n" + " ├── EOFError # Raised by input() when it hits end-of-file condition.\n" + " ├── LookupError # Raised when a look-up on a collection fails.\n" + " │ ├── IndexError # Raised when a sequence index is out of range.\n" + " │ └── KeyError # Raised when a dictionary key or set element is not found.\n" + " ├── NameError # Raised when a variable name is not found.\n" + " ├── OSError # Errors such as “file not found” or “disk full” (see Open).\n" + " │ └── FileNotFoundError # When a file or directory is requested but doesn't exist.\n" + " ├── RuntimeError # Raised by errors that don't fall in other categories.\n" + " │ └── RecursionError # Raised when the maximum recursion depth is exceeded.\n" + " ├── StopIteration # Raised by next() when run on an empty iterator.\n" + " ├── TypeError # Raised when an argument is of wrong type.\n" + " └── ValueError # When an argument is of right type but inappropriate value.\n" + " └── UnicodeError # Raised when encoding/decoding strings to/from bytes fails.\n"; const DIAGRAM_8_A = '+-----------+------------+------------+------------+\n' + '| | List | Set | Dict |\n' + '+-----------+------------+------------+------------+\n'; const DIAGRAM_8_B = '┏━━━━━━━━━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━┓\n' + '┃ │ List │ Set │ Dict ┃\n' + '┠───────────┼────────────┼────────────┼────────────┨\n' + '┃ getitem() │ IndexError │ │ KeyError ┃\n' + '┃ pop() │ IndexError │ KeyError │ KeyError ┃\n' + '┃ remove() │ ValueError │ KeyError │ ┃\n' + '┃ index() │ ValueError │ │ ┃\n' + '┗━━━━━━━━━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━┛\n'; const DIAGRAM_9_A = '+------------------+--------------+--------------+--------------+\n' + '| | excel | excel-tab | unix |\n' + '+------------------+--------------+--------------+--------------+\n'; const DIAGRAM_9_B = "┏━━━━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━┓\n" + "┃ │ excel │ excel-tab │ unix ┃\n" + "┠──────────────────┼──────────────┼──────────────┼──────────────┨\n" + "┃ delimiter │ ',' │ '\\t' │ ',' ┃\n" + "┃ quotechar │ '\"' │ '\"' │ '\"' ┃\n" + "┃ doublequote │ True │ True │ True ┃\n" + "┃ skipinitialspace │ False │ False │ False ┃\n" + "┃ lineterminator │ '\\r\\n' │ '\\r\\n' │ '\\n' ┃\n" + "┃ quoting │ 0 │ 0 │ 1 ┃\n" + "┃ escapechar │ None │ None │ None ┃\n" + "┗━━━━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━┛\n"; const DIAGRAM_10_A = '+-------------+-------------+\n' + '| Classes | Metaclasses |\n' + '+-------------+-------------|\n' + '| MyClass --> MyMetaClass |\n'; const DIAGRAM_10_B = '┏━━━━━━━━━━━━━┯━━━━━━━━━━━━━┓\n' + '┃ Classes │ Metaclasses ┃\n' + '┠─────────────┼─────────────┨\n' + '┃ MyClass ──→ MyMetaClass ┃\n' + '┃ │ ↓ ┃\n' + '┃ object ─────→ type ←╮ ┃\n' + '┃ │ ↑ ╰──╯ ┃\n' + '┃ str ──────────╯ ┃\n' + '┗━━━━━━━━━━━━━┷━━━━━━━━━━━━━┛\n'; const DIAGRAM_11_A = '+-------------+-------------+\n' + '| Classes | Metaclasses |\n' + '+-------------+-------------|\n' + '| MyClass | MyMetaClass |\n'; const DIAGRAM_11_B = '┏━━━━━━━━━━━━━┯━━━━━━━━━━━━━┓\n' + '┃ Classes │ Metaclasses ┃\n' + '┠─────────────┼─────────────┨\n' + '┃ MyClass │ MyMetaClass ┃\n' + '┃ ↓ │ ↓ ┃\n' + '┃ object ←───── type ┃\n' + '┃ ↑ │ ┃\n' + '┃ str │ ┃\n' + '┗━━━━━━━━━━━━━┷━━━━━━━━━━━━━┛\n'; const DIAGRAM_12_A = '+-----------+-------------+------+-------------+\n' + '| sampwidth | min | zero | max |\n' + '+-----------+-------------+------+-------------+\n'; const DIAGRAM_12_B = '┏━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━┯━━━━━━━━━━━━━┓\n' + '┃ sampwidth │ min │ zero │ max ┃\n' + '┠───────────┼─────────────┼──────┼─────────────┨\n' + '┃ 1 │ 0 │ 128 │ 255 ┃\n' + '┃ 2 │ -32768 │ 0 │ 32767 ┃\n' + '┃ 3 │ -8388608 │ 0 │ 8388607 ┃\n' + '┃ 4 │ -2147483648 │ 0 │ 2147483647 ┃\n' + '┗━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━┷━━━━━━━━━━━━━┛\n'; const DIAGRAM_13_A = '| sr.apply(…) | 3 | sum 3 | s 3 |'; const DIAGRAM_13_B = "┏━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━┓\n" + "┃ │ 'sum' │ ['sum'] │ {'s': 'sum'} ┃\n" + "┠─────────────┼─────────────┼─────────────┼───────────────┨\n" + "┃ sr.apply(…) │ 3 │ sum 3 │ s 3 ┃\n" + "┃ sr.agg(…) │ │ │ ┃\n" + "┗━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━┛\n"; const DIAGRAM_14_A = '| sr.apply(…) | | rank | |'; const DIAGRAM_14_B = "┏━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━┓\n" + "┃ │ 'rank' │ ['rank'] │ {'r': 'rank'} ┃\n" + "┠─────────────┼─────────────┼─────────────┼───────────────┨\n" + "┃ sr.apply(…) │ │ rank │ ┃\n" + "┃ sr.agg(…) │ x 1 │ x 1 │ r x 1 ┃\n" + "┃ sr.trans(…) │ y 2 │ y 2 │ y 2 ┃\n" + "┗━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━┛\n"; const DIAGRAM_15_A = '+------------------------+---------------+------------+------------+--------------------------+'; const DIAGRAM_15_B = "┏━━━━━━━━━━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━┓\n" + "┃ │ 'outer' │ 'inner' │ 'left' │ Description ┃\n" + "┠────────────────────────┼───────────────┼────────────┼────────────┼──────────────────────────┨\n" + "┃ l.merge(r, on='y', │ x y z │ x y z │ x y z │ Joins/merges on column. ┃\n" + "┃ how=…) │ 0 1 2 . │ 3 4 5 │ 1 2 . │ Also accepts left_on and ┃\n" + "┃ │ 1 3 4 5 │ │ 3 4 5 │ right_on parameters. ┃\n" + "┃ │ 2 . 6 7 │ │ │ Uses 'inner' by default. ┃\n" + "┠────────────────────────┼───────────────┼────────────┼────────────┼──────────────────────────┨\n" + "┃ l.join(r, lsuffix='l', │ x yl yr z │ │ x yl yr z │ Joins/merges on row keys.┃\n" + "┃ rsuffix='r', │ a 1 2 . . │ x yl yr z │ 1 2 . . │ Uses 'left' by default. ┃\n" + "┃ how=…) │ b 3 4 4 5 │ 3 4 4 5 │ 3 4 4 5 │ If r is a series, it is ┃\n" + "┃ │ c . . 6 7 │ │ │ treated as a column. ┃\n" + "┠────────────────────────┼───────────────┼────────────┼────────────┼──────────────────────────┨\n" + "┃ pd.concat([l, r], │ x y z │ y │ │ Adds rows at the bottom. ┃\n" + "┃ axis=0, │ a 1 2 . │ 2 │ │ Uses 'outer' by default. ┃\n" + "┃ join=…) │ b 3 4 . │ 4 │ │ A series is treated as a ┃\n" + "┃ │ b . 4 5 │ 4 │ │ column. Use l.append(r) ┃\n" + "┃ │ c . 6 7 │ 6 │ │ to add a row instead. ┃\n" + "┠────────────────────────┼───────────────┼────────────┼────────────┼──────────────────────────┨\n" + "┃ pd.concat([l, r], │ x y y z │ │ │ Adds columns at the ┃\n" + "┃ axis=1, │ a 1 2 . . │ x y y z │ │ right end. Uses 'outer' ┃\n" + "┃ join=…) │ b 3 4 4 5 │ 3 4 4 5 │ │ by default. A series is ┃\n" + "┃ │ c . . 6 7 │ │ │ treated as a column. ┃\n" + "┠────────────────────────┼───────────────┼────────────┼────────────┼──────────────────────────┨\n" + "┃ l.combine_first(r) │ x y z │ │ │ Adds missing rows and ┃\n" + "┃ │ a 1 2 . │ │ │ columns. Also updates ┃\n" + "┃ │ b 3 4 5 │ │ │ items that contain NaN. ┃\n" + "┃ │ c . 6 7 │ │ │ R must be a DataFrame. ┃\n" + "┗━━━━━━━━━━━━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━┛\n"; const DIAGRAM_16_A = '| df.apply(…) | | x y | |'; const DIAGRAM_16_B = "┏━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━┓\n" + "┃ │ 'sum' │ ['sum'] │ {'x': 'sum'} ┃\n" + "┠─────────────┼─────────────┼─────────────┼───────────────┨\n" + "┃ df.apply(…) │ │ x y │ ┃\n" + "┃ df.agg(…) │ x 4 │ sum 4 6 │ x 4 ┃\n" + "┃ │ y 6 │ │ ┃\n" + "┗━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━┛\n"; const DIAGRAM_17_A = '| df.apply(…) | x y | x y | x |'; const DIAGRAM_17_B = "┏━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━┓\n" + "┃ │ 'rank' │ ['rank'] │ {'x': 'rank'} ┃\n" + "┠─────────────┼─────────────┼─────────────┼───────────────┨\n" + "┃ df.apply(…) │ x y │ x y │ x ┃\n" + "┃ df.agg(…) │ a 1 1 │ rank rank │ a 1 ┃\n" + "┃ df.trans(…) │ b 2 2 │ a 1 1 │ b 2 ┃\n" + "┃ │ │ b 2 2 │ ┃\n" + "┗━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━┛\n"; const DIAGRAM_18_A = '| gb.agg(…) | x y | x y | x y | x |'; const DIAGRAM_18_B = "┏━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━┓\n" + "┃ │ 'sum' │ 'rank' │ ['rank'] │ {'x': 'rank'} ┃\n" + "┠─────────────┼─────────────┼─────────────┼─────────────┼───────────────┨\n" + "┃ gb.agg(…) │ x y │ x y │ x y │ x ┃\n" + "┃ │ z │ a 1 1 │ rank rank │ a 1 ┃\n" + "┃ │ 3 1 2 │ b 1 1 │ a 1 1 │ b 1 ┃\n" + "┃ │ 6 11 13 │ c 2 2 │ b 1 1 │ c 2 ┃\n" + "┃ │ │ │ c 2 2 │ ┃\n" + "┠─────────────┼─────────────┼─────────────┼─────────────┼───────────────┨\n" + "┃ gb.trans(…) │ x y │ x y │ │ ┃\n" + "┃ │ a 1 2 │ a 1 1 │ │ ┃\n" + "┃ │ b 11 13 │ b 1 1 │ │ ┃\n" + "┃ │ c 11 13 │ c 1 1 │ │ ┃\n" + "┗━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━━━┛\n"; function main() { const html = getMd(); initDom(html); modifyPage(); const template = readFile('web/template.html'); const tokens = template.split('
    '); const text = `${tokens[0]} ${document.body.innerHTML} ${tokens[1]}`; writeToFile('index.html', text); } function getMd() { var readme = readFile('README.md'); var readme = readme.replace("#semaphore-event-barrier", "#semaphoreeventbarrier"); const converter = new showdown.Converter(); return converter.makeHtml(readme); } function initDom(html) { const { JSDOM } = jsdom; const dom = new JSDOM(html); const $ = (require('jquery'))(dom.window); global.$ = $; global.document = dom.window.document; } function modifyPage() { removeOrigToc(); addToc(); insertLinks(); unindentBanner(); updateDiagrams(); highlightCode(); fixPandasDiagram(); removePlotImages(); } function removeOrigToc() { const headerContents = $('#contents'); const contentsList = headerContents.next(); headerContents.remove(); contentsList.remove(); } function addToc() { const nodes = $.parseHTML(TOC); $('#main').before(nodes); } function insertLinks() { $('h2').each(function() { const aId = $(this).attr('id'); const text = $(this).text(); const line = `#${text}`; $(this).html(line); }); } function unindentBanner() { const montyImg = $('img').first(); montyImg.parent().addClass('banner'); const downloadPraragrapth = $('p').first(); downloadPraragrapth.addClass('banner'); } function updateDiagrams() { $(`code:contains(${DIAGRAM_1_A})`).html(DIAGRAM_1_B); $(`code:contains(${DIAGRAM_2_A})`).html(DIAGRAM_2_B); $(`code:contains(${DIAGRAM_3_A})`).html(DIAGRAM_3_B); $(`code:contains(${DIAGRAM_4_A})`).html(DIAGRAM_4_B); $(`code:contains(${DIAGRAM_5_A})`).html(DIAGRAM_5_B); $(`code:contains(${DIAGRAM_6_A})`).html(DIAGRAM_6_B); $(`code:contains(${DIAGRAM_7_A})`).html(DIAGRAM_7_B); $(`code:contains(${DIAGRAM_8_A})`).html(DIAGRAM_8_B); $(`code:contains(${DIAGRAM_9_A})`).html(DIAGRAM_9_B); $(`code:contains(${DIAGRAM_10_A})`).html(DIAGRAM_10_B); $(`code:contains(${DIAGRAM_11_A})`).html(DIAGRAM_11_B); $(`code:contains(${DIAGRAM_12_A})`).html(DIAGRAM_12_B).removeClass("text").removeClass("language-text").addClass("python"); $(`code:contains(${DIAGRAM_13_A})`).html(DIAGRAM_13_B).removeClass("text").removeClass("language-text").addClass("python"); $(`code:contains(${DIAGRAM_14_A})`).html(DIAGRAM_14_B).removeClass("text").removeClass("language-text").addClass("python"); $(`code:contains(${DIAGRAM_15_A})`).html(DIAGRAM_15_B).removeClass("text").removeClass("language-text").addClass("python"); $(`code:contains(${DIAGRAM_16_A})`).html(DIAGRAM_16_B).removeClass("text").removeClass("language-text").addClass("python"); $(`code:contains(${DIAGRAM_17_A})`).html(DIAGRAM_17_B).removeClass("text").removeClass("language-text").addClass("python"); $(`code:contains(${DIAGRAM_18_A})`).html(DIAGRAM_18_B).removeClass("text").removeClass("language-text").addClass("python"); } function highlightCode() { setApaches(['', '', '
    ', '', '', '']); $('code').not('.python').not('.text').not('.bash').not('.apache').addClass('python'); $('code').each(function(index) { hljs.highlightBlock(this); }); fixClasses(); fixHighlights(); preventPageBreaks(); fixPageBreaksFile(); fixPageBreaksStruct(); insertPageBreaks(); } function setApaches(elements) { for (el of elements) { $(`code:contains(${el})`).addClass('apache'); } } function fixClasses() { // Changes class="hljs-keyword" to class="hljs-title" of 'class' keyword. $('.hljs-class').filter(':contains(class \')').find(':first-child').removeClass('hljs-keyword').addClass('hljs-title') } function fixHighlights() { $(`code:contains(@lru_cache(maxsize=None))`).html(LRU_CACHE); $(`code:contains((self, a=None):)`).html(CONSTRUCTOR_OVERLOADING); $(`code:contains(make_dataclass(\'\')`).html(DATACLASS); $(`code:contains(shutil.copy)`).html(SHUTIL_COPY); $(`code:contains(os.rename)`).html(OS_RENAME); $(`code:contains(\'\', , )`).html(TYPE); $(`code:contains(ValueError: malformed node)`).html(EVAL); $(`code:contains(pip3 install tqdm)`).html(PROGRESS_BAR); $(`code:contains(pip3 install pyinstaller)`).html(PYINSTALLER); $(`ul:contains(Only available in)`).html(INDEX); } function preventPageBreaks() { $(':header').each(function(index) { var el = $(this) var untilPre = el.nextUntil('pre') var untilH2 = el.nextUntil('h2') if ((untilPre.length < untilH2.length) || el.prop('tagName') === 'H1') { untilPre.add(el).next().add(el).wrapAll("
    "); } else { untilH2.add(el).wrapAll("
    "); } }); } function fixPageBreaksFile() { const modesDiv = $('#file').parent().parent().parent() move(modesDiv, 'file') move(modesDiv, 'exceptions-1') } function fixPageBreaksStruct() { const formatDiv = $('#floatingpointtypes').parent().parent().parent().parent() move(formatDiv, 'floatingpointtypes') move(formatDiv, 'integertypesuseacapitalletterforunsignedtypeminimumandstandardsizesareinbrackets') move(formatDiv, 'forstandardsizesstartformatstringwith') } function move(anchor_el, el_id) { const el = $('#'+el_id).parent() anchor_el.after(el) } function insertPageBreaks() { insertPageBreakBefore('#decorator') // insertPageBreakBefore('#print') } function insertPageBreakBefore(an_id) { $('
    ').insertBefore($(an_id).parent()) } function fixPandasDiagram() { const diagram_15 = '┏━━━━━━━━━━━━━━━━━━━━━━━━┯━━━━━━━━━━━━━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━┓'; $(`code:contains(${diagram_15})`).find(".hljs-keyword:contains(and)").after("and"); $(`code:contains(${diagram_15})`).find(".hljs-keyword:contains(as)").after("as"); $(`code:contains(${diagram_15})`).find(".hljs-keyword:contains(is)").after("is"); $(`code:contains(${diagram_15})`).find(".hljs-keyword").remove(); } function removePlotImages() { $('img[alt="Covid Deaths"]').remove(); $('img[alt="Covid Cases"]').remove(); } function readFile(filename) { try { return fs.readFileSync(filename, 'utf8'); } catch(e) { console.error('Error:', e.stack); } } function writeToFile(filename, text) { try { return fs.writeFileSync(filename, text, 'utf8'); } catch(e) { console.error('Error:', e.stack); } } main();