bare-script 3.0.16__tar.gz → 3.1.1__tar.gz

{bare_script-3.0.16/src/bare_script.egg-info → bare_script-3.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: bare-script
-Version: 3.0.16
+Version: 3.1.1
 Summary: bare-script
 Home-page: https://github.com/craigahobbs/bare-script
 Author: Craig A. Hobbs

{bare_script-3.0.16 → bare_script-3.1.1}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = bare-script
-version = 3.0.16
+version = 3.1.1
 url = https://github.com/craigahobbs/bare-script
 author = Craig A. Hobbs
 author_email = craigahobbs@gmail.com
@@ -23,7 +23,7 @@ classifiers =
 	Topic :: Utilities
 
 [options]
-packages = bare_script
+packages = bare_script, bare_script.include
 package_dir = 
 	= src
 install_requires = 
@@ -34,6 +34,12 @@ console_scripts =
 	bare = bare_script.bare:main
 	baredoc = bare_script.baredoc:main
 
+[options.package_data]
+bare_script = 
+	include/*.bare
+	include/*.mds
+	include/*.txt
+
 [egg_info]
 tag_build = 
 tag_date = 0

{bare_script-3.0.16 → bare_script-3.1.1}/src/bare_script/bare.py

@@ -7,6 +7,8 @@ bare-script command-line interface (CLI)
 
 import argparse
 from functools import partial
+import importlib.resources
+import os
 import sys
 import time
 
@@ -27,6 +29,7 @@ def main(argv=None):
     parser.add_argument('file', nargs='*', action=_FileScriptAction, help='files to process')
     parser.add_argument('-c', '--code', action=_InlineScriptAction, help='execute the BareScript code')
     parser.add_argument('-d', '--debug', action='store_true', help='enable debug mode')
+    parser.add_argument('-m', '--markdown-up', action='store_true', help='run with MarkdownUp stubs')
     parser.add_argument('-s', '--static', action='store_true', help='perform static analysis')
     parser.add_argument('-v', '--var', nargs=2, action='append', metavar=('VAR', 'EXPR'), default = [],
                         help='set a global variable to an expression value')
@@ -44,8 +47,13 @@ def main(argv=None):
         for var_name, var_expr in args.var:
             globals_[var_name] = evaluate_expression(parse_expression(var_expr))
 
+        # Get the scripts to run
+        scripts = args.scripts
+        if args.markdown_up:
+            scripts = [('code', 'include <markdownUp.bare>'), *scripts]
+
         # Parse and execute all source files in order
-        for script_type, script_value in args.scripts:
+        for script_type, script_value in scripts:
             # Get the script source
             if script_type == 'file':
                 script_name = script_value
@@ -85,10 +93,10 @@ def main(argv=None):
             time_begin = time.time()
             result = execute_script(script, {
                 'debug': args.debug or False,
-                'fetchFn': fetch_read_write,
+                'fetchFn': _fetch_include,
                 'globals': globals_,
                 'logFn': log_stdout,
-                'systemPrefix': 'https://craigahobbs.github.io/markdown-up/include/',
+                'systemPrefix': _FETCH_INCLUDE_PREFIX,
                 'urlFn': partial(url_file_relative, script_value) if script_type == 'file' else None
             })
             if isinstance(result, (int, float)) and int(result) == result and 0 <= result <= 255:
@@ -115,6 +123,20 @@ def main(argv=None):
     sys.exit(status_code)
 
 
+def _fetch_include(request):
+    # Is this a bare system include?
+    url = request['url']
+    if url.startswith(_FETCH_INCLUDE_PREFIX):
+        path = url[len(_FETCH_INCLUDE_PREFIX):]
+        with importlib.resources.files('bare_script.include').joinpath(path).open('rb') as cm_inc:
+            return cm_inc.read().decode(encoding='utf-8')
+
+    return fetch_read_write(request)
+
+
+_FETCH_INCLUDE_PREFIX = f':bare-include:{os.sep}'
+
+
 class _InlineScriptAction(argparse.Action):
     def __call__(self, parser, namespace, values, option_string=None):
         if 'scripts' not in namespace:

bare_script-3.1.1/src/bare_script/include/args.mds

@@ -0,0 +1,344 @@
+# Licensed under the MIT License
+# https://github.com/craigahobbs/markdown-up/blob/main/LICENSE
+
+
+# Include sentinel
+if systemGlobalGet('argsSentinel'):
+    return
+endif
+argsSentinel = true
+
+
+# The URL arguments model
+argsTypes = schemaParse( \
+    'group "Args"', \
+    '', \
+    '', \
+    '# An argument model list', \
+    'typedef ArgsArgument[len > 0] ArgsArguments', \
+    '', \
+    '', \
+    '# An argument model', \
+    'struct ArgsArgument', \
+    '', \
+    '    # The argument name', \
+    '    string(len > 0) name', \
+    '', \
+    '    # The argument type', \
+    '    optional ArgsType type', \
+    '', \
+    "    # The argument's global variable name", \
+    '    optional string(len > 0) global', \
+    '', \
+    '    # If true, the argument is explicit.', \
+    '    # An explicit argument is only included in the URL if it is in the arguments object.', \
+    '    optional bool explicit', \
+    '', \
+    '    # The default argument value', \
+    '    optional object default', \
+    '', \
+    '    # The argument description', \
+    '    optional string(len > 0) description', \
+    '', \
+    '', \
+    '# An argument value type', \
+    'enum ArgsType', \
+    '    bool', \
+    '    date', \
+    '    datetime', \
+    '    float', \
+    '    int', \
+    '    string' \
+)
+
+
+# $function: argsValidate
+# $group: args.mds
+# $doc: Validate an arguments model
+# $arg arguments: The [arguments model](includeModel.html#var.vName='ArgsArguments')
+# $return: The validated [arguments model](includeModel.html#var.vName='ArgsArguments') or null if validation fails
+function argsValidate(arguments):
+    validatedArguments = schemaValidate(argsTypes, 'ArgsArguments', arguments)
+
+    # Check for duplicate arguments
+    if validatedArguments != null:
+        argNames = objectNew()
+        for argument in arguments:
+            name = objectGet(argument, 'name')
+            if objectHas(argNames, name):
+                validatedArguments = null
+                systemLogDebug('MarkdownUp - args.mds: Duplicate argument "' + name + '"')
+            else:
+                objectSet(argNames, name, true)
+            endif
+        endfor
+    endif
+
+    return validatedArguments
+endfunction
+
+
+# $function: argsParse
+# $group: args.mds
+# $doc: Parse an [arguments model](includeModel.html#var.vName='ArgsArguments').
+# $doc: Argument globals are validated and added to the arguments object using the argument name.
+# $arg arguments: The [arguments model](includeModel.html#var.vName='ArgsArguments')
+# $return: The arguments object
+function argsParse(arguments):
+    # Create the arguments object
+    args = objectNew()
+    for argument in arguments:
+        # Get the argument value
+        global = argsGlobalName(argument)
+        value = argsValidateValue(systemGlobalGet(global), objectGet(argument, 'type'), global)
+
+        # Apply the default argument value, if any
+        if value == null:
+            value = objectGet(argument, 'default')
+        endif
+
+        # Set the argument value, if any
+        if value != null:
+            objectSet(args, objectGet(argument, 'name'), value)
+        endif
+    endfor
+
+    return args
+endfunction
+
+
+# $function: argsURL
+# $group: args.mds
+# $doc: Create a MarkdownUp application URL
+# $arg arguments: The [arguments model](includeModel.html#var.vName='ArgsArguments')
+# $arg args: Optional (default is null). The arguments object. Null argument values are excluded from the URL.
+# $arg explicit: Optional (default is false). If true, arguments are only included in the URL if they are in the arguments object.
+# $arg headerText: Optional (default is null). If non-null, the URL's header text.
+# $arg headerText: The special "_top" header ID scrolls to the top of the page.
+# $arg url: Optional (default is null). If non-null, the MarkdownUp URL hash parameter.
+# $return: The MarkdownUp application URL
+function argsURL(arguments, args, explicit, headerText, url):
+    # Get the URL variables
+    urlVars = arrayNew()
+    argNames = objectNew()
+    for argument in arguments:
+        name = objectGet(argument, 'name')
+        type = objectGet(argument, 'type')
+        global = argsGlobalName(argument)
+        default = objectGet(argument, 'default')
+
+        # Add the argument name (for unknown argument check below)
+        objectSet(argNames, name, null)
+
+        # Add the URL variable, if any
+        value = null
+        if args != null && objectHas(args, name):
+            value = argsValidateValue(objectGet(args, name), type, global)
+        elif !(explicit || objectGet(argument, 'explicit')):
+            value = argsValidateValue(systemGlobalGet(global), type, global, false)
+        endif
+
+        # Add the URL variable
+        if value != null && (default == null || !argsValuesEqual(value, default, type)):
+            arrayPush(urlVars, 'var.' + global + '=' + urlEncodeComponent(argsFormatValue(value, type)))
+        endif
+    endfor
+
+    # Sort the URL variables for general consistency
+    arraySort(urlVars)
+
+    # Check for unknown arguments
+    if args != null:
+        for name in objectKeys(args):
+            if !objectHas(argNames, name):
+                systemLogDebug('MarkdownUp - args.mds: Unknown argument "' + name + '"')
+            endif
+        endfor
+    endif
+
+    # Create the URL
+    return '#' + if(url != null, 'url=' + urlEncodeComponent(url) + '&', '') + \
+        if(arrayLength(urlVars), arrayJoin(urlVars, '&'), 'var=') + \
+        if(headerText != null, '&' + if(headerText == argsTopHeaderId, argsTopHeaderId, markdownHeaderId(headerText)), '')
+endfunction
+
+
+# The special "top" header ID
+argsTopHeaderId = '_top'
+
+
+# $function: argsLink
+# $group: args.mds
+# $doc: Create a Markdown link text to a MarkdownUp application URL
+# $arg arguments: The [arguments model](includeModel.html#var.vName='ArgsArguments')
+# $arg text: The link text
+# $arg args: Optional (default is null). The arguments object.
+# $arg explicit: Optional (default is false). If true, arguments are only included in the URL if they are in the arguments object.
+# $arg headerText: Optional (default is null). If non-null, the URL's header text.
+# $arg headerText: The special "_top" header ID scrolls to the top of the page.
+# $arg url: Optional (default is null). If non-null, the MarkdownUp URL hash parameter.
+# $return: The Markdown link text
+function argsLink(arguments, text, args, explicit, headerText, url):
+    return '[' + markdownEscape(text) + '](' + argsURL(arguments, args, explicit, headerText, url) + ')'
+endfunction
+
+
+# $function: argsHelp
+# $group: args.mds
+# $doc: Output the [arguments model's](includeModel.html#var.vName='ArgsArguments') help
+# $arg arguments: The [arguments model](includeModel.html#var.vName='ArgsArguments')
+function argsHelp(arguments):
+    # Create the help data
+    helpData = arrayNew()
+    anyDefault = false
+    anyExplicit = false
+    anyDescription = false
+    for argument in arguments:
+        type = objectGet(argument, 'type', 'string')
+        default = objectGet(argument, 'default')
+        explicit = objectGet(argument, 'explicit')
+        description = objectGet(argument, 'description')
+
+        # Add the help data row
+        arrayPush(helpData, objectNew( \
+            'Variable', argsGlobalName(argument), \
+            'Type', type, \
+            'Default', argsFormatValue(default, type), \
+            'Explicit', if(explicit, 'Yes', ''), \
+            'Description', if(description != null, description, '') \
+        ))
+
+        # Update the "any" field bools
+        anyDefault = anyDefault || (default != null)
+        anyExplicit = anyExplicit || explicit
+        anyDescription = anyDescription || (description != null)
+    endfor
+
+    # Render the help table
+    helpFields = arrayNew('Variable', 'Type')
+    if anyDefault:
+        arrayPush(helpFields, 'Default')
+    endif
+    if anyExplicit:
+        arrayPush(helpFields, 'Explicit')
+    endif
+    if anyDescription:
+        arrayPush(helpFields, 'Description')
+    endif
+    dataTable(helpData, objectNew('fields', helpFields))
+endfunction
+
+
+# Helper function to compute an argument's global name
+function argsGlobalName(argument):
+    global = objectGet(argument, 'global')
+    if global == null:
+        name = objectGet(argument, 'name')
+        global = 'v' + stringUpper(stringSlice(name, 0, 1)) + stringSlice(name, 1)
+    endif
+    return global
+endfunction
+
+
+# Helper function to format an argument value
+function argsFormatValue(value, type):
+    # No value?
+    if value == null:
+        return ''
+    endif
+
+    # Return the formatted value
+    if type == 'bool':
+        return if(value, 'true', 'false')
+    elif type == 'date':
+        return "'" + datetimeISOFormat(value, true) + "'"
+    elif type == 'datetime':
+        return "'" + datetimeISOFormat(value) + "'"
+    elif type == 'float':
+        return stringNew(value)
+    elif type == 'int':
+        return stringNew(value)
+    endif
+
+    # type == 'string'
+    return "'" + value + "'"
+endfunction
+
+
+# Helper function to validate an argument value's type
+function argsValidateValue(value, type, global, warn):
+    # No value?
+    if value == null:
+        return null
+    endif
+
+    # Validate the value's type
+    valueType = systemType(value)
+    if type == 'bool':
+        if valueType == 'number' && (value == 0 || value == 1):
+            value = !!value
+        elif valueType != 'boolean':
+            if warn != false:
+                systemLogDebug('MarkdownUp - args.mds: Invalid value ' + jsonStringify(value) + ' for URL argument "' + global + '"')
+            endif
+            value = null
+        endif
+    elif type == 'date':
+        valueOrig = value
+        if valueType == 'string':
+            value = datetimeISOParse(value)
+            valueType = systemType(value)
+        endif
+        if valueType != 'datetime' || datetimeHour(value) != 0 || datetimeMinute(value) != 0 || datetimeSecond(value) != 0:
+            if warn != false:
+                systemLogDebug('MarkdownUp - args.mds: Invalid value ' + jsonStringify(valueOrig) + ' for URL argument "' + global + '"')
+            endif
+            value = null
+        endif
+    elif type == 'datetime':
+        valueOrig = value
+        if valueType == 'string':
+            value = datetimeISOParse(value)
+            valueType = systemType(value)
+        endif
+        if valueType != 'datetime':
+            if warn != false:
+                systemLogDebug('MarkdownUp - args.mds: Invalid value ' + jsonStringify(valueOrig) + ' for URL argument "' + global + '"')
+            endif
+            value = null
+        endif
+    elif type == 'float':
+        if valueType != 'number':
+            if warn != false:
+                systemLogDebug('MarkdownUp - args.mds: Invalid value ' + jsonStringify(value) + ' for URL argument "' + global + '"')
+            endif
+            value = null
+        endif
+    elif type == 'int':
+        if valueType != 'number' || value != mathFloor(value):
+            if warn != false:
+                systemLogDebug('MarkdownUp - args.mds: Invalid value ' + jsonStringify(value) + ' for URL argument "' + global + '"')
+            endif
+            value = null
+        endif
+    else:
+        # type == 'string'
+        if valueType != 'string':
+            if warn != false:
+                systemLogDebug('MarkdownUp - args.mds: Invalid value ' + jsonStringify(value) + ' for URL argument "' + global + '"')
+            endif
+            value = null
+        endif
+    endif
+
+    return value
+endfunction
+
+
+# Helper function to determine if two values are equal
+function argsValuesEqual(value, valueOther, type):
+    if type == 'date' || type == 'datetime':
+        return (value - valueOther) == 0
+    endif
+    return value == valueOther
+endfunction

bare_script-3.1.1/src/bare_script/include/forms.mds

@@ -0,0 +1,79 @@
+# Licensed under the MIT License
+# https://github.com/craigahobbs/markdown-up/blob/main/LICENSE
+
+
+# Include sentinel
+if systemGlobalGet('formsSentinel'):
+    return
+endif
+formsSentinel = true
+
+
+# $function: formsTextElements
+# $group: forms.mds
+# $doc: Create a text input [element model](https://github.com/craigahobbs/element-model#readme)
+# $arg id: The text input element ID
+# $arg text: The initial text of the text input element
+# $arg size: Optional (default is null). The size, in characters, of the text input element
+# $arg onEnter: Optional (default is null). The text input element on-enter event handler
+# $return: The text input [element model](https://github.com/craigahobbs/element-model#readme)
+function formsTextElements(id, text, size, onEnter):
+    return objectNew( \
+        'html', 'input', \
+        'attr', objectNew( \
+            'autocomplete', 'off', \
+            'id', id, \
+            'style', 'font-size: inherit; border: thin solid black; padding: 0.4em;', \
+            'type', 'text', \
+            'value', text, \
+            'size', size \
+        ), \
+        'callback', if(onEnter != null, objectNew('keyup', systemPartial(formsTextOnKeyup, onEnter))) \
+    )
+endfunction
+
+
+async function formsTextOnKeyup(onEnter, keyCode):
+    if keyCode == 13:
+        onEnter()
+    endif
+endfunction
+
+
+# $function: formsLinkButtonElements
+# $group: forms.mds
+# $doc: Create a link button [element model](https://github.com/craigahobbs/element-model#readme)
+# $arg text: The link button's text
+# $arg onClick: The link button's click event handler
+# $return: The link button [element model](https://github.com/craigahobbs/element-model#readme)
+function formsLinkButtonElements(text, onClick):
+    return objectNew( \
+        'html', 'a', \
+        'attr', objectNew('style', 'cursor: pointer; user-select: none;'), \
+        'elem', objectNew('text', text), \
+        'callback', objectNew('click', onClick) \
+    )
+endfunction
+
+
+# $function: formsLinkElements
+# $group: forms.mds
+# $doc: Create a link [element model](https://github.com/craigahobbs/element-model#readme)
+# $arg text: The link's text
+# $arg url: The link's URL. If null, the link is rendered as text.
+# $return: The link [element model](https://github.com/craigahobbs/element-model#readme)
+function formsLinkElements(text, url):
+    if url == null:
+        return objectNew( \
+            'html', 'span', \
+            'attr', objectNew('style', 'user-select: none;'), \
+            'elem', objectNew('text', text) \
+        )
+    endif
+
+    return objectNew( \
+        'html', 'a', \
+        'attr', objectNew('href', documentURL(url)), \
+        'elem', objectNew('text', text) \
+    )
+endfunction