bare-script 4.2.6__tar.gz → 4.2.8__tar.gz

{bare_script-4.2.6/src/bare_script.egg-info → bare_script-4.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bare-script
-Version: 4.2.6
+Version: 4.2.8
 Summary: bare-script
 Home-page: https://github.com/craigahobbs/bare-script
 Author: Craig A. Hobbs
@@ -104,11 +104,11 @@ from bare_script import execute_script, fetch_http, parse_script
 
 # Parse the script
 script = parse_script('''\
-# Fetch the BareScript library documentation JSON
-docs = jsonParse(systemFetch('https://craigahobbs.github.io/bare-script-py/library/library.json'))
+# Fetch the BareScript builtin library documentation JSON
+docs = jsonParse(systemFetch('https://craigahobbs.github.io/bare-script-py/library/library-builtin.json'))
 
-# Return the number of library functions
-return 'The BareScript Library has ' + arrayLength(objectGet(docs, 'functions')) + ' functions'
+# Return the number of builtin functions
+return 'The BareScript Library has ' + arrayLength(objectGet(docs, 'functions')) + ' builtin functions'
 ''')
 
 # Execute the script
@@ -118,7 +118,7 @@ print(execute_script(script, {'fetchFn': fetch_http}))
 This outputs:
 
 ```
-The BareScript Library has 209 functions
+The BareScript Library has 108 builtin functions
 ```
 
 

{bare_script-4.2.6 → bare_script-4.2.8}/README.md

@@ -79,11 +79,11 @@ from bare_script import execute_script, fetch_http, parse_script
 
 # Parse the script
 script = parse_script('''\
-# Fetch the BareScript library documentation JSON
-docs = jsonParse(systemFetch('https://craigahobbs.github.io/bare-script-py/library/library.json'))
+# Fetch the BareScript builtin library documentation JSON
+docs = jsonParse(systemFetch('https://craigahobbs.github.io/bare-script-py/library/library-builtin.json'))
 
-# Return the number of library functions
-return 'The BareScript Library has ' + arrayLength(objectGet(docs, 'functions')) + ' functions'
+# Return the number of builtin functions
+return 'The BareScript Library has ' + arrayLength(objectGet(docs, 'functions')) + ' builtin functions'
 ''')
 
 # Execute the script
@@ -93,7 +93,7 @@ print(execute_script(script, {'fetchFn': fetch_http}))
 This outputs:
 
 ```
-The BareScript Library has 209 functions
+The BareScript Library has 108 builtin functions
 ```
 
 

{bare_script-4.2.6 → bare_script-4.2.8}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = bare-script
-version = 4.2.6
+version = 4.2.8
 url = https://github.com/craigahobbs/bare-script
 author = Craig A. Hobbs
 author_email = craigahobbs@gmail.com

bare_script-4.2.8/src/bare_script/include/baredoc.bare

@@ -0,0 +1,383 @@
+# Licensed under the MIT License
+# https://github.com/craigahobbs/bare-script/blob/main/LICENSE
+
+include <args.bare>
+include <markdown.bare>
+include <dataUtil.bare>
+include <dataTable.bare>
+include <schemaDoc.bare>
+
+
+# $function: baredocMain
+# $group: baredoc.bare
+# $doc: The BareScript library documentation application main entry point
+# $arg config: The [documentation configuration](model.html#var.vName='BaredocConfig') object or its JSON resource URL
+async function baredocMain(config):
+    # Parse arguments
+    args = argsParse(baredocArguments)
+    group = objectGet(args, 'group')
+    name = objectGet(args, 'name')
+    single = objectGet(args, 'single')
+
+    # Render the documentation model page?
+    if objectGet(args, 'doc'):
+        documentSetTitle('Library')
+        markdownPrint(schemaDocMarkdown(baredocTypes, 'BaredocLibrary'))
+        return
+    endif
+
+    # Resolve and validate the configuration
+    if systemType(config) == 'string':
+        config = jsonParse(systemFetch(config))
+    endif
+    config = schemaValidate(baredocTypes, 'BaredocConfig', config)
+    if config == null:
+        markdownPrint('**Error:** Invalid baredoc configuration')
+        return
+    endif
+    sections = objectGet(config, 'sections')
+
+    # Fetch and validate the section library documentation resources
+    sectionURLs = []
+    for section in sections:
+        arrayPush(sectionURLs, objectGet(section, 'url'))
+    endfor
+    sectionJSONs = systemFetch(sectionURLs)
+
+    # Group each section's functions by name, with the config content and description
+    groups = {}
+    sectionGroups = []
+    for section, ixSection in sections:
+        sectionJSON = arrayGet(sectionJSONs, ixSection)
+        libraryPart = if(sectionJSON != null, jsonParse(sectionJSON))
+        libraryPart = if(libraryPart != null, schemaValidate(baredocTypes, 'BaredocLibrary', libraryPart))
+        if libraryPart == null:
+            markdownPrint( \
+                '**Error:** Failed to fetch library documentation resource "' + \
+                markdownEscape(objectGet(section, 'url')) + '"' \
+            )
+            return
+        endif
+
+        # Group the section's functions
+        sectionGroupSet = {}
+        for function_ in objectGet(libraryPart, 'functions'):
+            groupName = objectGet(function_, 'group')
+            groupEntry = objectGet(groups, groupName)
+            if groupEntry == null:
+                groupEntry = {'functions': []}
+                objectSet(groups, groupName, groupEntry)
+            endif
+            arrayPush(objectGet(groupEntry, 'functions'), function_)
+            objectSet(sectionGroupSet, groupName, true)
+        endfor
+        arrayPush(sectionGroups, {'title': objectGet(section, 'title'), 'groupNames': arraySort(objectKeys(sectionGroupSet))})
+
+        # Attach the section's group content and description from the config
+        for group_ in objectGet(section, 'groups', []):
+            groupEntry = objectGet(groups, objectGet(group_, 'name'))
+            if groupEntry != null:
+                objectSet(groupEntry, 'content', objectGet(group_, 'content'))
+                objectSet(groupEntry, 'description', objectGet(group_, 'description'))
+            endif
+        endfor
+    endfor
+
+    # Sort each group's functions by name
+    for groupName in objectKeys(groups):
+        arraySort(objectGet(objectGet(groups, groupName), 'functions'), baredocFunctionCompare)
+    endfor
+
+    # Function requested by name? Redirect to its group page anchor
+    if name != null:
+        for groupName in objectKeys(groups):
+            for function_ in objectGet(objectGet(groups, groupName), 'functions'):
+                if objectGet(function_, 'name') == name:
+                    windowSetLocation(argsURL(baredocArguments, {'group': groupName, 'name': null}, false, name))
+                    return
+                endif
+            endfor
+        endfor
+        markdownPrint('', '**Error:** Unknown function "' + markdownEscape(name) + '"')
+        return
+    endif
+
+    # Render the requested page
+    if group != null:
+        baredocGroupPage(config, args, groups, group)
+    elif single:
+        baredocSinglePage(config, args, sectionGroups, groups)
+    else:
+        baredocIndexPage(config, args, sectionGroups, groups)
+    endif
+endfunction
+
+
+# The BareScript library documentation application arguments
+baredocArguments = argsValidate([ \
+    {'name': 'doc', 'type': 'bool', 'default': false}, \
+    {'name': 'group'}, \
+    {'name': 'name'}, \
+    {'name': 'publish', 'type': 'bool', 'default': false}, \
+    {'name': 'single', 'type': 'bool', 'default': false} \
+])
+
+
+# Helper to compare library function objects by name
+function baredocFunctionCompare(f1, f2):
+    f1Name = objectGet(f1, 'name')
+    f2Name = objectGet(f2, 'name')
+    return if(f1Name < f2Name, -1, if(f1Name == f2Name, 0, 1))
+endfunction
+
+
+# Helper to render the title and top-level content
+async function baredocPageHeader(config):
+    title = objectGet(config, 'title')
+    documentSetTitle(title)
+    markdownPrint('# ' + markdownEscape(title))
+    topContent = objectGet(config, 'content')
+    if topContent != null:
+        topText = systemFetch(topContent)
+        markdownPrint('', if(topText != null, topText, '**Error:** Failed to load "' + markdownEscape(topContent) + '"'))
+    endif
+endfunction
+
+
+# Render the section group index tables (single uses in-page anchors, multi-page uses group pages)
+function baredocGroupTable(sectionGroups, groups, single):
+    for section in sectionGroups:
+        markdownPrint('', '## ' + markdownEscape(objectGet(section, 'title')), '')
+        markdownPrint('|  |  |', '| --- | --- |')
+        for groupName in objectGet(section, 'groupNames'):
+            groupLink = if(single, \
+                argsLink(baredocArguments, groupName, null, false, groupName), \
+                argsLink(baredocArguments, groupName, {'group': groupName}, false, argsTopHeaderId))
+            description = objectGet(objectGet(groups, groupName), 'description')
+            markdownPrint('| ' + groupLink + ' | ' + if(description != null, description, '') + ' |')
+        endfor
+    endfor
+endfunction
+
+
+# Render a library documentation index page
+async function baredocIndexPage(config, args, sectionGroups, groups):
+    # Render the title and top-level content
+    baredocPageHeader(config)
+
+    # Render the single page toggle
+    if !objectGet(args, 'publish'):
+        markdownPrint('', argsLink(baredocArguments, 'Single Page', {'single': true}))
+    endif
+
+    # Render the section group index tables
+    baredocGroupTable(sectionGroups, groups, false)
+endfunction
+
+
+# Render the single-page library documentation
+async function baredocSinglePage(config, args, sectionGroups, groups):
+    # Render the title and top-level content
+    baredocPageHeader(config)
+
+    # Render the multi page toggle
+    if !objectGet(args, 'publish'):
+        markdownPrint('', argsLink(baredocArguments, 'Multi Page', {'single': false}))
+    endif
+
+    # Render the section group index tables
+    baredocGroupTable(sectionGroups, groups, true)
+
+    # Batch-fetch all group content, keyed by group name
+    contentNames = []
+    urls = []
+    for groupName in objectKeys(groups):
+        url = objectGet(objectGet(groups, groupName), 'content')
+        if url != null:
+            arrayPush(contentNames, groupName)
+            arrayPush(urls, url)
+        endif
+    endfor
+    texts = systemFetch(urls)
+    groupContent = {}
+    for groupName, ixName in contentNames:
+        text = arrayGet(texts, ixName)
+        objectSet(groupContent, groupName, if(text != null, text, '**Error:** Failed to load "' + markdownEscape(arrayGet(urls, ixName)) + '"'))
+    endfor
+
+    # Render each group, separated by a horizontal rule
+    for section in sectionGroups:
+        for groupName in objectGet(section, 'groupNames'):
+            markdownPrint('', '---', '')
+            baredocGroup(args, objectGet(groupContent, groupName), groups, groupName, '##')
+        endfor
+    endfor
+endfunction
+
+
+# Render a library documentation group page
+async function baredocGroupPage(config, args, groups, groupName):
+    title = objectGet(config, 'title')
+
+    # Set the document title
+    documentSetTitle(title + ' - ' + groupName)
+
+    # Group exist?
+    if !objectHas(groups, groupName):
+        markdownPrint('', '**Error:** Unknown group "' + markdownEscape(groupName) + '"')
+        return
+    endif
+
+    # Fetch the group content
+    url = objectGet(objectGet(groups, groupName), 'content')
+    groupContent = null
+    if url != null:
+        text = systemFetch(url)
+        groupContent = if(text != null, text, '**Error:** Failed to load "' + markdownEscape(url) + '"')
+    endif
+
+    # Render the index link and the group
+    markdownPrint(argsLink(baredocArguments, 'Index', {'group': null}), '')
+    baredocGroup(args, groupContent, groups, groupName, '#')
+endfunction
+
+
+# Render a documentation group's content, function index, and function documentation
+function baredocGroup(args, groupContent, groups, groupName, baseHeader):
+    publish = objectGet(args, 'publish')
+    single = objectGet(args, 'single')
+    groupEntry = objectGet(groups, groupName)
+
+    # Render the group header
+    markdownPrint(baseHeader + ' ' + markdownEscape(groupName))
+    if single && !publish:
+        markdownPrint('', argsLink(baredocArguments, 'Back to top', null, false, argsTopHeaderId))
+    endif
+
+    # Render the group content (the fetched content or load error, else the description)
+    content = if(groupContent != null, groupContent, objectGet(groupEntry, 'description'))
+    if content != null:
+        markdownPrint('', content)
+    endif
+
+    # Render the group function index
+    groupFunctions = objectGet(groupEntry, 'functions')
+    markdownPrint('', baseHeader + '# Function Index', '')
+    for function_ in groupFunctions:
+        functionName = objectGet(function_, 'name')
+        markdownPrint('- ' + argsLink(baredocArguments, functionName, null, false, functionName))
+    endfor
+
+    # Render the group function documentation
+    for function_ in groupFunctions:
+        # Render the function header
+        markdownPrint( \
+            '', \
+            '---', \
+            '', \
+            baseHeader + '# ' + markdownEscape(objectGet(function_, 'name')), \
+            '', \
+            objectGet(function_, 'doc') \
+        )
+
+        # Render the functions's argument documentation
+        markdownPrint('', baseHeader + '## Arguments')
+        arguments = objectGet(function_, 'args')
+        if arguments != null:
+            for argument in arguments:
+                markdownPrint('', '**' + markdownEscape(objectGet(argument, 'name')) + ' -**', objectGet(argument, 'doc'))
+            endfor
+        else:
+            markdownPrint('', 'None')
+        endif
+
+        # Render the function's return documentation
+        markdownPrint('', baseHeader + '## Returns')
+        returnDoc = objectGet(function_, 'return')
+        markdownPrint('', if(returnDoc != null, returnDoc, 'Nothing'))
+    endfor
+endfunction
+
+
+# The library documentation schema
+baredocTypes = schemaParse( \
+    'group "baredoc.bare"', \
+    '', \
+    '', \
+    '# The baredoc documentation application configuration', \
+    'struct BaredocConfig', \
+    '', \
+    '    # The documentation title', \
+    '    string title', \
+    '', \
+    '    # The optional top-level Markdown content resource URL', \
+    '    optional string content', \
+    '', \
+    '    # The documentation sections', \
+    '    BaredocSection[] sections', \
+    '', \
+    '', \
+    '# A documentation section', \
+    'struct BaredocSection', \
+    '', \
+    '    # The section title', \
+    '    string title', \
+    '', \
+    "    # The section's library documentation JSON resource URL", \
+    '    string url', \
+    '', \
+    '    # Optional content and descriptions for the groups (groups are defined by the library functions)', \
+    '    optional BaredocGroup[] groups', \
+    '', \
+    '', \
+    "# A library function group's content and description (the group is defined by the library functions)", \
+    'struct BaredocGroup', \
+    '', \
+    '    # The group name (matches a library function group)', \
+    '    string name', \
+    '', \
+    '    # The optional group Markdown content resource URL (defaults to the description)', \
+    '    optional string content', \
+    '', \
+    '    # The optional brief group description Markdown for the index page', \
+    '    optional string description', \
+    '', \
+    '', \
+    '# A library documentation model', \
+    'struct BaredocLibrary', \
+    '', \
+    '    # The library functions', \
+    '    BaredocFunction[] functions', \
+    '', \
+    '', \
+    '# A library function', \
+    'struct BaredocFunction', \
+    '', \
+    '    # The function name', \
+    '    string name', \
+    '', \
+    '    # The function group (e.g. "Math")', \
+    '    string group', \
+    '', \
+    "    # The function's documentation Markdown lines", \
+    '    string[] doc', \
+    '', \
+    '    # The function arguments', \
+    '    optional BaredocFunctionArgument[] args', \
+    '', \
+    "    # The function return's documentation Markdown lines", \
+    '    optional string[] return', \
+    '', \
+    '    # If true, ignore the function', \
+    '    optional bool ignore', \
+    '', \
+    '', \
+    '# A function argument', \
+    'struct BaredocFunctionArgument', \
+    '', \
+    '    # The argument name', \
+    '    string name', \
+    '', \
+    "    # The argument's documentation Markdown lines", \
+    '    string[] doc' \
+)

{bare_script-4.2.6 → bare_script-4.2.8}/src/bare_script/library.py

@@ -2208,3 +2208,17 @@ EXPRESSION_FUNCTIONS = dict(
     (expr_fn_name, SCRIPT_FUNCTIONS[script_fn_name])
     for expr_fn_name, script_fn_name in EXPRESSION_FUNCTION_MAP.items()
 )
+
+
+# Library functions with an inline "intrinsic" fast path in the runtime call dispatch. Membership is by
+# function-object identity, so any override (a user function, an options global, or an unittestMock
+# systemGlobalSet) is a different object that misses the set and takes the normal call path. Kept small
+# on purpose: these hot, validation-heavy accessors measured as ~all of the include-test speedup.
+# Defined here, next to SCRIPT_FUNCTIONS, mirroring the JavaScript implementation.
+INTRINSICS = frozenset((
+    SCRIPT_FUNCTIONS['arrayGet'],
+    SCRIPT_FUNCTIONS['arrayPush'],
+    SCRIPT_FUNCTIONS['arraySet'],
+    SCRIPT_FUNCTIONS['objectGet'],
+    SCRIPT_FUNCTIONS['objectSet'],
+))

{bare_script-4.2.6 → bare_script-4.2.8}/src/bare_script/runtime.py

@@ -8,7 +8,7 @@ The BareScript runtime
 import datetime
 import functools
 
-from .library import EXPRESSION_FUNCTIONS, SCRIPT_FUNCTIONS
+from .library import EXPRESSION_FUNCTIONS, INTRINSICS, SCRIPT_FUNCTIONS
 from .model import lint_script
 from .options import url_file_relative
 from .parser import parse_script
@@ -315,6 +315,109 @@ def evaluate_expression(expr, options=None, locals_=None, builtins=True, script=
         if func_value is not None:
             # Call the function
             try:
+                # Intrinsic fast path: run the body inline, skipping value_args_validate and the
+                # call frame. Bad arguments raise ValueArgsError, handled by the except below exactly
+                # as the normal call would; a call reaching one of these under a different name (an
+                # alias) matches no branch and falls through to the normal call.
+                if func_value in INTRINSICS:
+                    func_args_length = len(func_args)
+                    if func_name == 'arrayGet':
+                        if func_args_length < 1:
+                            raise ValueArgsError('array', None)
+                        array_value = func_args[0]
+                        array_type = type(array_value)
+                        if array_type is not list:
+                            raise ValueArgsError('array', array_value)
+                        if func_args_length < 2:
+                            raise ValueArgsError('index', None)
+                        index_value = func_args[1]
+                        index_type = type(index_value)
+                        if index_type is float:
+                            if index_value < 0 or not index_value.is_integer():
+                                raise ValueArgsError('index', index_value)
+                            index_value = int(index_value)
+                        elif index_type is int:
+                            if index_value < 0:
+                                raise ValueArgsError('index', index_value)
+                        else:
+                            raise ValueArgsError('index', index_value)
+                        if func_args_length > 2:
+                            raise ValueArgsError(None, func_args_length)
+                        if index_value >= len(array_value):
+                            raise ValueArgsError('index', index_value)
+                        return array_value[index_value]
+                    if func_name == 'arrayPush':
+                        if func_args_length < 1:
+                            raise ValueArgsError('array', None)
+                        array_value = func_args[0]
+                        array_type = type(array_value)
+                        if array_type is not list:
+                            raise ValueArgsError('array', array_value)
+                        array_value.extend(func_args[1:])
+                        return array_value
+                    if func_name == 'arraySet':
+                        if func_args_length < 1:
+                            raise ValueArgsError('array', None)
+                        array_value = func_args[0]
+                        array_type = type(array_value)
+                        if array_type is not list:
+                            raise ValueArgsError('array', array_value)
+                        if func_args_length < 2:
+                            raise ValueArgsError('index', None)
+                        index_value = func_args[1]
+                        index_type = type(index_value)
+                        if index_type is float:
+                            if index_value < 0 or not index_value.is_integer():
+                                raise ValueArgsError('index', index_value)
+                            index_value = int(index_value)
+                        elif index_type is int:
+                            if index_value < 0:
+                                raise ValueArgsError('index', index_value)
+                        else:
+                            raise ValueArgsError('index', index_value)
+                        if func_args_length > 3:
+                            raise ValueArgsError(None, func_args_length)
+                        if index_value >= len(array_value):
+                            raise ValueArgsError('index', index_value)
+                        set_value = func_args[2] if func_args_length >= 3 else None
+                        array_value[index_value] = set_value
+                        return set_value
+                    if func_name == 'objectGet':
+                        default_value = func_args[2] if func_args_length >= 3 else None
+                        if func_args_length < 1:
+                            raise ValueArgsError('object', None, default_value)
+                        object_value = func_args[0]
+                        object_type = type(object_value)
+                        if object_type is not dict:
+                            raise ValueArgsError('object', object_value, default_value)
+                        if func_args_length < 2:
+                            raise ValueArgsError('key', None, default_value)
+                        key_value = func_args[1]
+                        key_type = type(key_value)
+                        if key_type is not str:
+                            raise ValueArgsError('key', key_value, default_value)
+                        if func_args_length > 3:
+                            raise ValueArgsError(None, func_args_length, default_value)
+                        return object_value.get(key_value, default_value)
+                    if func_name == 'objectSet':
+                        if func_args_length < 1:
+                            raise ValueArgsError('object', None)
+                        object_value = func_args[0]
+                        object_type = type(object_value)
+                        if object_type is not dict:
+                            raise ValueArgsError('object', object_value)
+                        if func_args_length < 2:
+                            raise ValueArgsError('key', None)
+                        key_value = func_args[1]
+                        key_type = type(key_value)
+                        if key_type is not str:
+                            raise ValueArgsError('key', key_value)
+                        if func_args_length > 3:
+                            raise ValueArgsError(None, func_args_length)
+                        set_value = func_args[2] if func_args_length >= 3 else None
+                        object_value[key_value] = set_value
+                        return set_value
+
                 return func_value(func_args, options)
             except BareScriptRuntimeError:
                 raise

{bare_script-4.2.6 → bare_script-4.2.8/src/bare_script.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bare-script
-Version: 4.2.6
+Version: 4.2.8
 Summary: bare-script
 Home-page: https://github.com/craigahobbs/bare-script
 Author: Craig A. Hobbs
@@ -104,11 +104,11 @@ from bare_script import execute_script, fetch_http, parse_script
 
 # Parse the script
 script = parse_script('''\
-# Fetch the BareScript library documentation JSON
-docs = jsonParse(systemFetch('https://craigahobbs.github.io/bare-script-py/library/library.json'))
+# Fetch the BareScript builtin library documentation JSON
+docs = jsonParse(systemFetch('https://craigahobbs.github.io/bare-script-py/library/library-builtin.json'))
 
-# Return the number of library functions
-return 'The BareScript Library has ' + arrayLength(objectGet(docs, 'functions')) + ' functions'
+# Return the number of builtin functions
+return 'The BareScript Library has ' + arrayLength(objectGet(docs, 'functions')) + ' builtin functions'
 ''')
 
 # Execute the script
@@ -118,7 +118,7 @@ print(execute_script(script, {'fetchFn': fetch_http}))
 This outputs:
 
 ```
-The BareScript Library has 209 functions
+The BareScript Library has 108 builtin functions
 ```
 
 

bare_script-4.2.6/src/bare_script/include/baredoc.bare

@@ -1,340 +0,0 @@
-# Licensed under the MIT License
-# https://github.com/craigahobbs/bare-script/blob/main/LICENSE
-
-include <args.bare>
-include <markdown.bare>
-include <dataUtil.bare>
-include <dataTable.bare>
-include <schemaDoc.bare>
-
-
-# $function: baredocMain
-# $group: baredoc.bare
-# $doc: The BareScript library documentation application main entry point
-# $arg url: The library documentation JSON resource URL
-# $arg title: The library title
-# $arg menuLinks: Optional array of text/URL menu link tuples
-# $arg groupURLs: Optional map of group name to group Markdown content URL ('' is index) or JSON resource URL
-async function baredocMain(url, title, menuLinks, groupURLs):
-    # Parse arguments
-    args = argsParse(baredocArguments)
-    group = objectGet(args, 'group')
-    name = objectGet(args, 'name')
-    single = objectGet(args, 'single')
-    url = objectGet(args, 'url', url)
-
-    # Render library JSON documentation page?
-    if objectGet(args, 'doc'):
-        documentSetTitle('Library')
-        markdownPrint(schemaDocMarkdown(baredocTypes, 'BaredocLibrary'))
-        return
-    endif
-
-    # Fetch and validate the library documentation resource
-    groups = {}
-    urls = if(systemType(url) == 'array', url, [url])
-    for libraryJSON, ixLibrary in systemFetch(urls):
-        libraryPart = if(libraryJSON != null, jsonParse(libraryJSON))
-        libraryPart = if(libraryPart != null, schemaValidate(baredocTypes, 'BaredocLibrary', libraryPart))
-        if libraryPart == null:
-            libraryURL = arrayGet(urls, ixLibrary)
-            markdownPrint('**Error:** Failed to fetch library documentation resource "' + markdownEscape(libraryURL) + '"')
-            return
-        endif
-
-        # Group the function documentation
-        for function_ in objectGet(libraryPart, 'functions'):
-            groupName = objectGet(function_, 'group')
-            groupFunctions = objectGet(groups, groupName)
-            if groupFunctions == null:
-                groupFunctions = []
-                objectSet(groups, groupName, groupFunctions)
-            endif
-            arrayPush(groupFunctions, function_)
-        endfor
-    endfor
-
-    # Group URLs?
-    if groupURLs != null:
-        # Fetch the group URLs, if necessary
-        if systemType(groupURLs) == 'string':
-            groupURLs = jsonParse(systemFetch(groupURLs))
-        endif
-
-        # Add an empty group for any missing group URLs
-        for groupName in objectKeys(groupURLs):
-            if groupName != '' && !objectHas(groups, groupName):
-                objectSet(groups, groupName, [])
-            endif
-        endfor
-    endif
-
-    # Sort the group functions
-    for groupName in objectKeys(groups):
-        groupFunctions = objectGet(groups, groupName)
-        arraySort(groupFunctions, baredocFunctionCompare)
-
-        # Function requested by name?
-        if name != null:
-            for function_ in groupFunctions:
-                functionName = objectGet(function_, 'name')
-                if functionName == name:
-                    # Redirect to the actual URL
-                    windowSetLocation( \
-                        argsURL(baredocArguments, {'group': objectGet(function_, 'group'), 'name': null}, false, functionName) \
-                    )
-                    return
-                endif
-            endfor
-        endif
-    endfor
-    if name != null:
-        markdownPrint('', '**Error:** Unknown function "' + markdownEscape(name) + '"')
-        return
-    endif
-
-    # Fetch the group content URLs
-    groupContent = {}
-    if groupURLs != null:
-        # Fetch the content URLs
-        groupURLArray = []
-        groupNames = arraySort(objectKeys(groupURLs))
-        for groupName in groupNames:
-            arrayPush(groupURLArray, objectGet(groupURLs, groupName))
-        endfor
-        groupContentArray = systemFetch(groupURLArray)
-
-        # Assign the group contents
-        for groupName, ixGroupName in groupNames:
-            objectSet(groupContent, groupName, arrayGet(groupContentArray, ixGroupName))
-        endfor
-    endif
-
-    # Render the page
-    title = if(title != null && !objectHas(args, 'url'), title, url)
-    if group != null:
-        baredocGroupPage(args, title, groupURLs, groupContent, groups, group)
-    elif single:
-        baredocSinglePage(args, title, menuLinks, groupURLs, groupContent, groups)
-    else:
-        baredocIndexPage(args, title, menuLinks, groupURLs, groupContent, groups)
-    endif
-endfunction
-
-
-# The BareScript library documentation application arguments
-baredocArguments = argsValidate([ \
-    {'name': 'doc', 'type': 'bool', 'default': false}, \
-    {'name': 'group'}, \
-    {'name': 'name'}, \
-    {'name': 'publish', 'type': 'bool', 'default': false}, \
-    {'name': 'single', 'type': 'bool', 'default': false}, \
-    {'name': 'url', 'global': 'vURL'} \
-])
-
-
-# Helper to compare library function objects by name
-function baredocFunctionCompare(f1, f2):
-    f1Name = objectGet(f1, 'name')
-    f2Name = objectGet(f2, 'name')
-    return if(f1Name < f2Name, -1, if(f1Name == f2Name, 0, 1))
-endfunction
-
-
-# Render a library documentation index page
-function baredocIndexPage(args, title, menuLinks, groupURLs, groupContent, groups):
-    publish = objectGet(args, 'publish')
-
-    # Render the menu and title
-    documentSetTitle(title)
-    if menuLinks != null && arrayLength(menuLinks) > 0 && !publish:
-        menuSpacer = '&nbsp;|&nbsp;'
-        for menuLink, ixMenuLink in menuLinks:
-            menuLinkText = arrayGet(menuLink, 0)
-            menuLinkURL = arrayGet(menuLink, 1)
-            markdownPrint(if(ixMenuLink == 0, '', menuSpacer) + '[' + markdownEscape(menuLinkText) + '](' + urlEncode(menuLinkURL) + ')')
-        endfor
-        markdownPrint('')
-    endif
-    markdownPrint('# ' + markdownEscape(title))
-
-    # Render the index Markdown, if any
-    if objectHas(groupContent, ''):
-        rootURL = objectGet(groupURLs, '')
-        rootMarkdown = objectGet(groupContent, '')
-        markdownPrint('', if(rootMarkdown != null, rootMarkdown, '**Error:** Failed to load "' + markdownEscape(rootURL) + '"'))
-    endif
-
-    # Render the single page toggle
-    if !publish:
-        markdownPrint('', argsLink(baredocArguments, 'Single Page', {'single': true}))
-    endif
-
-    # Render the library function index
-    markdownPrint('', '## Table of Contents', '')
-    for groupName in arraySort(objectKeys(groups)):
-        markdownPrint('- ' + argsLink(baredocArguments, groupName, {'group': groupName}, false, argsTopHeaderId))
-    endfor
-endfunction
-
-
-# Render the single-page library documentation
-function baredocSinglePage(args, title, menuLinks, groupURLs, groupContent, groups):
-    publish = objectGet(args, 'publish')
-
-    # Render the menu and title
-    documentSetTitle(title)
-    if menuLinks != null && arrayLength(menuLinks) > 0 && !publish:
-        menuSpacer = '&nbsp;|&nbsp;'
-        for menuLink, ixMenuLink in menuLinks:
-            menuLinkText = arrayGet(menuLink, 0)
-            menuLinkURL = arrayGet(menuLink, 1)
-            markdownPrint(if(ixMenuLink == 0, '', menuSpacer) + '[' + markdownEscape(menuLinkText) + '](' + urlEncode(menuLinkURL) + ')')
-        endfor
-        markdownPrint('')
-    endif
-    markdownPrint('# ' + markdownEscape(title))
-
-    # Render the index Markdown, if any
-    if objectHas(groupContent, ''):
-        rootURL = objectGet(groupURLs, '')
-        rootMarkdown = objectGet(groupContent, '')
-        markdownPrint('', if(rootMarkdown != null, rootMarkdown, '**Error:** Failed to load "' + markdownEscape(rootURL) + '"'))
-    endif
-
-    # Render the single page toggle
-    if !publish:
-        markdownPrint('', argsLink(baredocArguments, 'Multi Page', {'single': false}))
-    endif
-
-    # The table of contents
-    markdownPrint('', '## Table of Contents', '')
-    for groupName in arraySort(objectKeys(groups)):
-        markdownPrint('- ' + argsLink(baredocArguments, groupName, null, false, groupName))
-    endfor
-
-    # Render the library function index
-    for groupName in arraySort(objectKeys(groups)):
-        markdownPrint('', '---', '')
-        baredocGroupPage(args, title, groupURLs, groupContent, groups, groupName)
-    endfor
-endfunction
-
-
-# Render a library documentation group page
-function baredocGroupPage(args, title, groupURLs, groupContent, groups, groupName):
-    publish = objectGet(args, 'publish')
-    single = objectGet(args, 'single')
-    baseHeader = if(single, '##', '#')
-
-    if !single:
-        # Set the document title
-        documentSetTitle(title + ' - ' + groupName)
-
-        # Group exist?
-        if !objectHas(groups, groupName):
-            markdownPrint('', '**Error:** Unknown group "' + markdownEscape(groupName) + '"')
-            return
-        endif
-    endif
-
-    # Render the menu and title
-    if !single:
-        markdownPrint(argsLink(baredocArguments, 'Index', {'group': null}), '')
-    endif
-    markdownPrint(baseHeader + ' ' + markdownEscape(groupName))
-    if single && !publish:
-        markdownPrint('', argsLink(baredocArguments, 'Back to top', null, false, '_top'))
-    endif
-
-    # Render the group Markdown, if any
-    if objectHas(groupContent, groupName):
-        groupURL = objectGet(groupURLs, groupName)
-        groupMarkdown = objectGet(groupContent, groupName)
-        markdownPrint('', if(groupMarkdown != null, groupMarkdown, '**Error:** Failed to load "' + markdownEscape(groupURL) + '"'))
-    endif
-
-    # Render the group function index
-    groupFunctions = objectGet(groups, groupName)
-    if arrayLength(groupFunctions) != 0:
-        markdownPrint('', baseHeader + '# Function Index', '')
-    endif
-    for function_, ixFunction in groupFunctions:
-        functionName = objectGet(function_, 'name')
-        markdownPrint('- ' + argsLink(baredocArguments, functionName, null, false, functionName))
-    endfor
-
-    # Render the group function documentation
-    for function_ in groupFunctions:
-        # Render the function header
-        markdownPrint( \
-            '', \
-            '---', \
-            '', \
-            baseHeader + '# ' + markdownEscape(objectGet(function_, 'name')), \
-            '', \
-            objectGet(function_, 'doc') \
-        )
-
-        # Render the functions's argument documentation
-        markdownPrint('', baseHeader + '## Arguments')
-        arguments = objectGet(function_, 'args')
-        if arguments != null:
-            for argument in arguments:
-                markdownPrint('', '**' + markdownEscape(objectGet(argument, 'name')) + ' -**', objectGet(argument, 'doc'))
-            endfor
-        else:
-            markdownPrint('', 'None')
-        endif
-
-        # Render the function's return documentation
-        markdownPrint('', baseHeader + '## Returns')
-        returnDoc = objectGet(function_, 'return')
-        markdownPrint('', if(returnDoc != null, returnDoc, 'Nothing'))
-    endfor
-endfunction
-
-
-# The library documentation schema
-baredocTypes = schemaParse( \
-    'group "baredoc.bare"', \
-    '', \
-    '', \
-    '# A library documentation model', \
-    'struct BaredocLibrary', \
-    '', \
-    '    # The library functions', \
-    '    BaredocFunction[] functions', \
-    '', \
-    '', \
-    '# A library function', \
-    'struct BaredocFunction', \
-    '', \
-    '    # The function name', \
-    '    string name', \
-    '', \
-    '    # The function group (e.g. "Math")', \
-    '    string group', \
-    '', \
-    "    # The function's documentation Markdown lines", \
-    '    string[] doc', \
-    '', \
-    '    # The function arguments', \
-    '    optional BaredocFunctionArgument[] args', \
-    '', \
-    "    # The function return's documentation Markdown lines", \
-    '    optional string[] return', \
-    '', \
-    '    # If true, ignore the function', \
-    '    optional bool ignore', \
-    '', \
-    '', \
-    '# A function argument', \
-    'struct BaredocFunctionArgument', \
-    '', \
-    '    # The argument name', \
-    '    string name', \
-    '', \
-    "    # The argument's documentation Markdown lines", \
-    '    string[] doc' \
-)