# Copyright (C) 2015 Sam Parkinson # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program. If not, see . import re import sys import json HELP = '''Usage: python pluginify.py (file) or python pluginify.py (file) > plugin.json Converts an RTP (readable TurtleBlocks plugin) file into a JSON file to load into Turtle Blocks JS. For more information, run `python pluginify.py syntax` ''' SYNTAX = ''' In an RST file, new blocks are not defined with braces (as is typical of Javascript); rather they start whenever you add //* *// and their scope is until the next block starts (or the end of file in the case that it is the last block). To add a comment, just type //* comment *// followed by your multi- line comment. pluginify ignores comments, i.e., they are not added in the JSON plugin. Example: //* comment *// Your single or multi line comment here... Global variables are defined in a section //* globals *//. Example: //* globals *// var calories = 0; var protein = 0; var carbohydrate = 0; var fiber = 0; var fat = 0; Define all the global variables under the section //* block-globals *//. These definitions will be added to all the code blocks in the created JSON output. Note that these "globals" included in each block but are local in context to each block. Example: You can define a common API Key to be used by all blocks. //* block-globals *// var mashapeKey = '(keycode)'; in globals. You can also declare global variables specific to argument blocks that get applied to a set of similar blocks, e.g., the variables under //* arg-globals *// will be added to all the arg blocks. Example: //* arg-globals *// var block = blocks.blockList[blk]; var connections = block.connections; You can declare functions for parameter blocks to be evaluated when the block labels are updated with the //* parameter:(blockname) *// tag. Example: //* parameter:loudness *// if (mic == null) {errorMsg("The microphone is not available."); value = 0; } else { value = Math.round(mic.getLevel() * 1000); } To define a block you need to type: //* block:(blockname) *// Example: //* block:power *// var block = new ProtoBlock('power'); block.palette = palettes.dict['maths']; blocks.protoBlockDict['power'] = block; block.twoArgMathBlock(); block.defaults.push(10, 2); block.staticLabels.push('power', 'base', 'exp.'); You should also define a setter for a parameter block (if appropriate). You can do this using the setter setion: //* setter:myValue *// myValue = value; updateDisplayOfMyValue(); Graphical elements (icons, colors) are defined in the own sections: Palette icons are defined as //* palette-icon:(palette name) *// Example: //* palette-icon:food *// ... Similarly for block colors: Example: //* palette-fill:food *// #FFFFFF //* palette-stroke:food *// #A0A0A0 //* palette-highlight:food *// #D5D5D5 Plugins can specify code to be executed on load, on start, and on stop. Example: //* onload:foo *// your code here... NOTE: name of on load, on start, and on stop sections must match the name of one of the plugin blocks. ''' def clear(): global NAMES, JS_TYPES, IMAGES NAMES = { 'flow': 'FLOWPLUGINS', 'arg': 'ARGPLUGINS', 'block': 'BLOCKPLUGINS', 'parameter': 'PARAMETERPLUGINS', 'setter': 'SETTERPLUGINS', 'onload': 'ONLOAD', 'onstart': 'ONSTART', 'onstop': 'ONSTOP', 'palette-icon': 'PALETTEPLUGINS', 'palette-fill': 'PALETTEFILLCOLORS', 'palette-stroke': 'PALETTESTROKECOLORS', 'palette-highlight': 'PALETTEHIGHLIGHTCOLORS', 'palette-stroke-highlight': 'HIGHLIGHTSTROKECOLORS'} JS_TYPES = ('flow', 'arg', 'block', 'parameter', 'setter', 'onload', 'onstart', 'onstop') # 'blkName': 'imageData', IMAGES = [] def pluginify(data): clear() sections_list = data.split('//*') sections_pairs = [] specific_globals = {x: '' for x in JS_TYPES} globals_ = None for section in sections_list: match = re.match('(.*)\*\/\/([^\0]*)', section.strip()) if match: if match.group(1).strip() == 'globals': globals_ = match.group(2).strip() elif match.group(1).strip().endswith('-globals'): type_, _ = match.group(1).strip().split('-') specific_globals[type_] = specific_globals[type_] + \ match.group(2).strip() elif match.group(1).strip() == 'comment': continue else: sections_pairs.append((match.group(1).strip(), match.group(2).strip())) outp = {} if globals_ is not None: outp['GLOBALS'] = globals_.replace('\n', '').replace('var ', '') for key, value in sections_pairs: if len(key.split(':')) != 2: raise ValueError('Section names should have 1 colon (type:name)') type_, name = key.split(':') if type_ in JS_TYPES: value = specific_globals[type_] + value value = value.replace('\n', '') if type_ in NAMES: type_ = NAMES[type_] if type_ not in outp: outp[type_] = [] outp[type_].append([name,value]) if type_ == 'image': # TODO: Detect if its png IMAGES.append([name, 'data:image/svg+xml;utf8,' + value]) if IMAGES: outp['IMAGES'] = IMAGES return json.dumps(outp, indent=4) if __name__ == '__main__': if len(sys.argv) != 2: print HELP elif sys.argv[1] in ('help', '-h', '--help'): print HELP elif sys.argv[1] == 'syntax': print SYNTAX else: with open(sys.argv[1]) as f: data = f.read() print pluginify(data)