unisi 0.1.0__py3-none-any.whl

unisi-0.1.0.dist-info/METADATA

@@ -0,0 +1,422 @@
+Metadata-Version: 2.1
+Name: unisi
+Version: 0.1.0
+Summary: UNified System Interface, GUI and proxy
+Author-Email: UNISI Tech <g.dernovoy@gmail.com>
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/unisi-tech/unisi
+Requires-Python: >=3.10
+Requires-Dist: aiohttp
+Requires-Dist: jsoncomparison
+Requires-Dist: jsonpickle
+Requires-Dist: pandas
+Requires-Dist: requests
+Requires-Dist: watchdog
+Requires-Dist: websockets
+Description-Content-Type: text/markdown
+
+# UNISI #
+UNified System Interface and GUI
+
+### Purpose ###
+UNISI technology provides a unified system interface and advanced program functionality, eliminating the need for front-end and most back-end programming. It automates common tasks, as well as unique ones, significantly reducing the necessity for manual programming and effort.
+
+### Provided functionality without programming ###
+-Automatic WEB interface
+-Unified interaction protocol support
+-Automatic configuring
+-Multi-user support
+-Hot reloading and updating
+-Integral autotesting
+-Protocol schema auto validation
+-Voice interaction (not released yet)
+-Developing data pipelines (not released yet)
+
+### Installing ###
+```
+pip install unisi
+```
+
+### How it works inside ###
+ The server sends protocol data to the front-end UNISI which has built-in tools (autodesigner) and automatically builds a standart Google Material Design GUI for the user data. No markup, drawing instructions and the other dull job are required. From the constructed Unisi screen the server receives a JSON message flow which fully describes what the user did. The message format is {screen, block, element, event, value}, "value" is the JSON value of the action/event that has happened. The server can either accept the change or roll it back by sending an info window about an inconsistency. The server can open a dialog box, send popup Warning, Error,.. or an entirely new screen. Unisi instantly and automatically displays actual server state. 
+
+### Programming ###
+This repo explains how to work with Unisi using Python and the tiny but optimal framework for that. Unisi web version is included in this library.  Supports Python 3.10 and up.
+
+
+### High level - Screen ###
+The program directory has to contain a screens folder which contains all screens which Unisi has to show.
+
+Screen example tests/screens/main.py
+```
+name = "Main"
+blocks = [block] 
+```
+The block example with a table and a selector
+```
+table = Table('Videos', 0, headers = ['Video', 'Duration',  'Links', 'Mine'],rows = [
+    ['opt_sync1_3_0.mp4', '30 seconds',  '@Refer to signal1', True],
+    ['opt_sync1_3_0.mp4', '37 seconds',  '@Refer to signal8', False]    
+])
+#widgets are groped in a block (complex widget)
+block = Block('X Block',
+    [           
+        Button('Clean table', icon = 'swipe'),
+        Select('Select', value='All', options=['All','Based','Group'])
+    ], table, icon = 'api')
+```
+
+| Screen global variables |	Status | Type | Description |
+| :---: | :---: | :---: | :---: | 
+| name  | Has to be defined | str | Unique screen name |
+| blocks | Has to be defined | list |which blocks to show on the screen |
+| user   | Always defined, read-only | User+ | Access to User(inherited) class which associated with a current user |
+| header | Optional | str | show it instead of app name |
+| toolbar | Optional | list | Gui elements to show in the screen toolbar |
+| order | Optional | int | order in the program menu |
+| icon  | Optional | str | MD icon of screen to show in the screen menu |
+| prepare | Optional | def prepare() | Syncronizes GUI elements one to another and with the program/system data. If defined then is called before screen appearing. |
+
+
+### Server start ###
+tests/template/run.py
+```
+import unisi
+unisi.start('Test app') 
+```
+Unisi builds the interactive app for the code above.
+Connect a browser to localhast:8000 which are by default and will see:
+
+![image](https://github.com/Claus1/unisi/assets/1247062/d73a5f2b-eaae-46d3-907b-14fb7d60475b)
+
+### Handling events ###
+All handlers are functions which have a signature
+```
+def handler_x(gui_object, value_x)
+```
+where gui_object is a Python object the user interacted with and value for the event.
+
+All Gui objects except Button have a field ‘value’. 
+For an edit field the value is a string or number, for a switch or check button the value is boolean, for table is row id or index, e.t.c.
+When a user changes the value of the Gui object or presses Button, the server calls the ‘changed’ function handler.
+
+```
+def clean_table(_, value):
+    table.rows = []
+    return table
+clean_button = Button('Clean the table’, clean_table)
+```
+
+| Handler returns |	Description |
+| :---: | :---: | 
+| Gui object |  Object to update |
+| Gui object array or tuple |  Objects to update |
+| None | Nothing to update, Ok |
+| Error(...), Warning(...), Info(...) | Show to user info about a problem. |
+| UpdateScreen, True | Redraw whole screen |
+| Dialog(..) | Open a dialog with parameters |
+| user.set_screen(screen_name) | switch to another screen |
+
+
+Unisi	synchronizes GUI state on frontend-end automatically after calling a handler.
+
+If a Gui object doesn't have 'changed' handler the object accepts incoming value automatically to the 'value' variable of gui object.
+
+If 'value' is not acceptable instead of returning an object possible to return Error or Warning or Info. That functions can update a object list passed after the message argument.
+
+```
+def changed_range(_, value):
+   if value < 0.5 and value > 1.0:
+       #or Error(message, _) if we want to return the previous visible value to the field, return gui object _ also.
+       return Error(f‘The value of {_.name} has to be > 0.5 and < 1.0!', _) 
+    #accept value othewise
+    _.value = value
+
+edit = Edit('Range of involving', 0.6, changed_range, type = 'number')
+```
+
+### Block details ###
+The width and height of blocks is calculated automatically depending on their children. It is possible to set the block width, or make it scrollable , for example for images list. Possible to add MD icon to the header, if required. width, scroll, height, icon are optional.
+```
+#Block(name, *children, **options)
+block = Block(‘Pictures’,add_button, images, width = 500, scroll = True,icon = 'api')
+```
+ 
+The first Block child is a widget(s) which are drawn in the block header just after its name.
+Blocks can be shared between the user screens with its states. Such a block has to be located in the 'blocks' folder .
+Examples of such block tests/blocks/tblock.py:
+```
+from unisi import *
+..
+concept_block = Block('Concept block',
+   [   #some gui elements       
+       Button('Run',run_proccess),
+       Edit('Working folder','run_folder')
+   ], result_table)
+```
+If some elements are enumerated inside an array, Unisi will display them on a line one after another, otherwise everyone will be displayed on a new own line(s).
+ 
+Using a shared block in some screen:
+```
+from blocks.tblock import concept_block
+...
+blocks = [.., concept_block]
+```
+
+#### Events interception of shared elements ####
+Interception handlers have the same in/out format as usual handlers.
+#### They are called before the inner element handler call. They cancel the call of inner element handler but you can call it as shown below.
+For example above interception of select_mode changed event will be:
+```
+@handle(select_mode, 'changed')
+def do_not_select_mode_x(selector, value):
+    if value == 'Mode X':
+        return Error('Do not select Mode X in this context', selector) # send old value for update select_mode to the previous state
+    return _.accept(value) #otherwise accept the value
+```
+
+#### Layout of blocks. #### 
+If the blocks are simply listed Unisi draws them from left to right or from top to bottom depending on the orientation setting. If a different layout is needed, it can be set according to the following rule: if the vertical area must contain more than one block, then the enumeration in the array will arrange the elements vertically one after another. If such an element enumeration is an array of blocks, then they will be drawn horizontally in the corresponding area.
+
+#### Example ####
+blocks = [ [b1,b2], [b3, [b4, b5]]]
+#[b1,b2] - the first vertical area, [b3, [b4, b5]] - the second one.
+
+![image](https://github.com/Claus1/unisi/assets/1247062/75d0f64c-d457-43c6-a909-0c97f4b4ab0f)
+
+### Basic gui elements ###
+Normally they have type property which says unisi what data it contains and optionally how to draw the element. 
+#### If the element name starts from _ , unisi will hide its name on the screen. ####
+if we need to paint an icon in an element, add 'icon': 'any MD icon name' to the element constructor.
+
+#### Most constructor parameters are optional for Gui elements except the first one which is the element name. ####
+
+Common form for element constructors:
+```
+Gui('Name', value = some_value, changed = changed_handler)
+#It is possible to use short form, that is equal:
+Gui('Name', some_value, changed_handler)
+```
+calling the method 
+def accept(self, value) 
+causes  a call changed handler if it defined, otherwise just save value to self.value
+
+### Button ###
+Normal button.
+```
+Button('Push me', changed = push_callback) 
+```
+Short form
+```
+Button('Push me', push_callback) 
+```
+Icon button 
+```
+Button('_Check', push_callback, icon = 'check')
+```
+
+### Load to server Button ###
+Special button provides file loading from user device or computer to the Unisi server.
+```
+UploadButton('Load', handler_when_loading_finish, icon='photo_library')
+```
+handler_when_loading_finish(button_, the_loaded_file_filename) where the_loaded_file_filename is a file name in upload server folder. This folder name is defined in config.py .
+
+### Edit and Text field. ###
+```
+Edit('Some field', '') #for string value
+Edit('Number field', 0.9, type = 'number') #changed handler will get a number
+```
+If set edit = false it will be readonly field.
+```
+Edit('Some field', '', edit = false) 
+#text
+Text('Some text')
+```
+complete handler is optional function which accepts the current edit value and returns a string list for autocomplete.
+
+```
+def get_complete_list(gui_element, current_value):
+    return [s for s in vocab if current_value in s]    
+
+Edit('Edit me', 'value', complete = get_complete_list) #value has to be string or number
+```
+
+Optional 'update' handler is called when the user press Enter in the field.
+It can return None if OK or objects for updating as usual 'changed' handler.
+
+Optional selection property with parameters (start, end) is called when selection is happened.
+Optional autogrow property uses for serving multiline fileds.
+
+
+### Radio button ###
+```
+Switch(name, value, changed, type = ...)
+value is boolean, changed is an optional handler.
+Optional type can be 'check' for a status button or 'switch' for a switcher . 
+```
+
+### Select group. Contains options field. ###
+```
+Select('Select something', "choice1", selection_is_changed, options = ["choice1","choice2", "choice3"]) 
+```
+Optional type parameter can be 'toggles','list','dropdown'. Unisi automatically chooses between toogles and dropdown, if type is omitted,
+if type = 'list' then Unisi build it as vertical select list.
+
+
+### Image. ###
+width,changed,height,header are optional, changed is called if the user select or touch the image.
+When the user click the image, a check mark is appearing on the image, showning select status of the image.
+It is usefull for image list, gallery, e.t.c
+```
+Image(image_name, selecting_changed, header = 'description',url = ...,  width = .., height = ..)
+```
+
+### Video. ###
+width and height are optional.
+```
+Video(video_url, width = .., height = ..)
+```
+
+### Tree. The element for tree-like data. ###
+```
+Tree(name, selected_item_name, changed_handler, options = {name1: parent1, name2 : None, .})
+```
+options is a tree structure, a dictionary {item_name:parent_name}. 
+parent_name is None for root items. changed_handler gets item key (name) as value. 
+
+### Table. ###
+Tables is common structure for presenting 2D data and charts. 
+Optional append, delete, update handlers are called for adding, deleting and updating rows.
+
+
+Assigning a handler for such action causes Unii to draw and activate an appropriate action icon button in the table header automatically.
+```
+table = Table('Videos', [0], row_changed, headers = ['Video', 'Duration', 'Owner', 'Status'],  
+  rows = [
+    ['opt_sync1_3_0.mp4', '30 seconds', 'Admin', 'Processed'],
+    ['opt_sync1_3_0.mp4', '37 seconds', 'Admin', 'Processed']
+  ], 
+  multimode = false, update = update)
+```
+Unisi counts rows id as an index in a rows array. If table does not contain append, delete arguments, then it will be drawn without add and remove icons.  
+value = [0] means 0 row is selected in multiselect mode (in array). multimode is False so switch icon for single select mode will be not drawn and switching to single select mode is not allowed.
+
+| Table option parameter |	Description |
+| :---: | :---: | 
+| changed  | table handler accept the selected row number |
+| complete |  Autocomplete handler as with value type (string value, (row index, column index)) that returns a string list of possible complitions |
+| append |  A handler gets new row index and return filled row with proposed values, has system append_table_row by default |
+| delete | A handler gets list or index of selected rows and remove them. system delete_table_row by default |
+| update | called when the user presses the Enter in a table cell |
+| modify | default = accept_rowvalue(table, value). called when the cell value is changed by the user |
+| edit   | default True. if true user can edit table, using standart or overloaded table methods |
+| tools  | default True, then  Table has toolbar with search field and icon action buttons. |
+| show   | default False, the table scrolls to (the first) selected row, if True and it is not visible |
+| multimode | default True, allows to select single or multi selection mode |
+
+
+### Table handlers. ###
+complete, modify and update have the same format as the others handlers, but value is consisted from the cell value and its position in the table.
+
+
+```
+def table_updated(table_, tabval):
+    value, position = tabval
+    #check value
+    ...
+    if error_found:
+        return Error('Can not accept the value!')
+    accept_rowvalue(table_, tabval)
+```
+
+### Chart ###
+Chart is a table with additional Table constructor parameter 'view' which explaines unisi how to draw a chart. The format is '{x index}-{y index1},{y index2}[,..]'. '0-1,2,3' means that x axis values will be taken from 0 column, and y values from 1,2,3 columns of row data.
+'i-3,5' means that x axis values will be equal the row indexes in rows, and y values from 3,5 columns of rows data. If a table constructor got view = '..' parameter then unisi displays a chart icon at the table header, pushing it switches table mode to the chart mode. If a table constructor got type = 'chart' in addition to view parameter the table will be displayed as a chart on start. In the chart mode pushing the icon button on the top right switches back to table view mode.
+
+### Graph ###
+Graph supports an interactive graph.
+```
+graph = Graph('X graph', graph_value, graph_selection, 
+    nodes = [
+     { 'id' : 'node1', 'label': "Node 1" },
+     { 'id' : 'node2', 'label': "Node 2" },
+     { 'id' : 'node3', 'label': "Node 3" }    
+  ], edges = [
+     { 'id' : 'edge1', 'source': "node1", 'target': "node2", 'label' : 'extending' },
+     { 'id' :'edge2' , 'source': "node2", 'target': "node3" , 'label' : 'extending'}     
+  ])
+```
+where graph_value is a dictionary like {'nodes' : ["node1"], 'edges' : ['edge3']}, where enumerations are selected nodes and edges.
+Constant graph_default_value == {'nodes' : [], 'edges' : []} i.e. nothing to select.
+
+'changed' method graph_selector called when user (de)selected nodes or edges:
+```
+def graph_selection(_, val):
+    _.value = val
+    if 'nodes' in val:        
+        return Info(f'Nodes {val["nodes"]}') 
+    if 'edges' in val:
+        return Info(f"Edges {val['edges']}") 
+```
+With pressed 'Shift' multi select works for nodes and edges.
+
+id nodes and edges are optinal, if node ids are ommited then edge 'source' and 'target' have to point node index in nodes array.
+
+### Dialog ###
+```
+Dialog(text, dialog_callback, commands = ['Ok', 'Cancel'], *content)
+```
+where buttons is a list of the dialog button names,
+Dialog callback has the signature as other with a pushed button name value
+```
+def dialog_callback(current_dialog, pushed_button_name):
+    if pushed_button_name == 'Yes':
+        do_this()
+    elif ..
+```
+content can be filled with Gui elements for additional dialog functionality.
+
+
+### Popup windows ###
+They are intended for non-blocking displaying of error messages and informing about some events, for example, incorrect user input and the completion of a long process on the server.
+```
+Info(info_message, *someGUIforUpdades)
+Warning(warning_message, *someGUIforUpdades)
+Error(error_message, *someGUIforUpdades)
+```
+They are returned by handlers and cause appearing on the top screen colored rectangles window for 3 second. someGUIforUpdades is optional GUI enumeration for updating.
+
+For long time processes it is possible to create Progress window. It is just call user.progress in any place.
+Open window 
+```
+user.progress("Analyze .. Wait..")
+```
+Update window message 
+```
+user.progress(" 1% is done..")
+```
+Close window user.progress(None) or automatically when the handler returns something.
+
+### Milti-user support. ###
+Unisi automatically creates and serves an environment for every user.
+The management class is User contains all required methods for processing and handling the user activity. A programmer can redefine methods in the inherited class, point it as system user class and that is all. Such methods suit for history navigation, undo/redo and initial operations. The screen folder contains screens which are recreated for every user. The same about blocks. The code and modules outside that folders are common for all users as usual. By default Unisi uses the system User class and you do not need to point it. 
+```
+class Hello_user(unisi.User):
+    def __init__(self):
+        super().__init__()
+        print('New Hello user connected and created!')
+
+unisi.start('Hello app', user_type = Hello_user)
+```
+In screens and blocks sources we can access the user by 'user' variable
+```
+print(isinstance(user, Hello_user))
+```
+
+More info about User class methods you can find in user.py in the souce dir.
+
+Examples are in tests folder.
+
+Demo project and UNISI part https://github.com/Claus1/cvtools
+

unisi-0.1.0.dist-info/RECORD

@@ -0,0 +1,37 @@
+unisi-0.1.0.dist-info/METADATA,sha256=l4lJ2RKJ-UwfdQjKLHt7sbgF_3akw14vG8ZWZTQdCF0,18595
+unisi-0.1.0.dist-info/WHEEL,sha256=N2J68yzZqJh3mI_Wg92rwhw0rtJDFpZj9bwQIMJgaVg,90
+unisi-0.1.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+unisi/__init__.py,sha256=bQ7yTDcgybkbIGTjxkajTbBJXtgyryrCvt3nXg8QxlQ,175
+unisi/autotest.py,sha256=mqf6FPPewadwQenG_rgZhhLZEhvZ0H_kLGH1570aLho,8053
+unisi/common.py,sha256=oQJdUHVIf3QEMlnRSY_FW-ce4oDb7xcmzOhHByKGC7w,753
+unisi/containers.py,sha256=_oB1KknoHAslpmVHY_dpX4uOcKtP5Pelqdv9fMjotHo,3403
+unisi/guielements.py,sha256=79-DTtUpKH4mBYbnKKzLQVgagBxk3bwKRGvfwNbl71A,5399
+unisi/proxy.py,sha256=YENWammF8xSAgHKUSQJqLVFXhnwdZOGA_sAPSqqEfa8,5728
+unisi/reloader.py,sha256=X4bxZn0P6Ey7mj4SAs8rz4RjEtpXd8vny1aGbyYnnik,6424
+unisi/server.py,sha256=SKN38DjuxZ0U_FjBJDuwnpDP2YfZorpIJrjrADhqf5w,4521
+unisi/tables.py,sha256=YJPylz28aTYJ44xF2JJ4P8yiSbgCtsyFEUI99rB-j50,4241
+unisi/users.py,sha256=X0jUP8vTbsPX0r4rYEacOVoqFU1IQxYveTdhdGtLsJI,9886
+unisi/utils.py,sha256=KnyjouXGnN8ubuwogMa1tu2HJSkmDqhuFf7RpU3n9bY,2971
+unisi/web/css/169.3abcdd94.css,sha256=5r_UnC_UWorIOB_Wxta6uEkma5feD5MP-63UsVKV4JE,2723
+unisi/web/css/app.31d6cfe0.css,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+unisi/web/css/vendor.9ed7638d.css,sha256=p_6HvcTaHu2zmOmfGxEGiGu5TIFZ75_XKHJZWA0eGCE,220597
+unisi/web/favicon.ico,sha256=2ZcJaY_4le4w5NSBzWjaj3yk1faLAX0XqioI-Tjscbs,64483
+unisi/web/fonts/KFOkCnqEu92Fr1MmgVxIIzQ.68bb21d0.woff,sha256=NOlYLBNxo7OiA4Amba6ZTtxureGS3_GkBh3WURNSwQI,20436
+unisi/web/fonts/KFOlCnqEu92Fr1MmEU9fBBc-.48af7707.woff,sha256=nOfzrEe5F0OJOi0p_lEafr7HrvUrLqmF-hJ0SNHyJ8E,20544
+unisi/web/fonts/KFOlCnqEu92Fr1MmSU5fBBc-.c2f7ab22.woff,sha256=vxTH13NLj5yGO5gqTnsw1DYa-Oh0fyyoZyuljnA-lqM,20416
+unisi/web/fonts/KFOlCnqEu92Fr1MmWUlfBBc-.77ecb942.woff,sha256=4P1XwNlTfZyYhLaorYwYI4ANlNz7aizJiHgP5lpZL-Y,20408
+unisi/web/fonts/KFOlCnqEu92Fr1MmYUtfBBc-.f5677eb2.woff,sha256=9lN-MiY-bEm_Wb1uSVK2vwbI8JFSxbAWNl_vcONYVs8,20424
+unisi/web/fonts/KFOmCnqEu92Fr1Mu4mxM.f1e2a767.woff,sha256=8qv3-6vimOWCPSV-SPXcITjG1eDCEAZvdrAGfo7aGU8,20344
+unisi/web/fonts/flUhRq6tzZclQEJ-Vdg-IuiaDsNa.4d73cb90.woff,sha256=_YT4i0lwQNT31ejJ-GNa740-cGwPpS4rb6zxTu6H5SI,164912
+unisi/web/fonts/flUhRq6tzZclQEJ-Vdg-IuiaDsNcIhQ8tQ.c5371cfb.woff2,sha256=Sk28YvozXkEblKUyvgkcWMDAxPpzEznxFyJXfTz2RDs,128616
+unisi/web/icons/favicon-128x128.png,sha256=zmGg0n6RZ5OM4gg-E5HeHuUUtA2KD1w2AqegT0SfZ3k,12324
+unisi/web/icons/favicon-16x16.png,sha256=3ynBFHJjwaUFKcZVC2rBs27b82r64dmcvfFzEo52-sU,859
+unisi/web/icons/favicon-32x32.png,sha256=lhGXZOqIhjcKDymmbKyo4mrVmKY055LMD5GO9eW2Qjk,2039
+unisi/web/icons/favicon-96x96.png,sha256=0PbP5YF01VHbwwP8z7z8jjltQ0q343C1wpjxWjj47rY,9643
+unisi/web/index.html,sha256=hDsDzmlBU6AO_dpCYbtLuS-sFZsYHWLloD1edJF7DKo,907
+unisi/web/js/169.f952e294.js,sha256=Vz929BAarhcMBvsblKOfhk9o4fIcux84AMBUiLEtr_k,55870
+unisi/web/js/193.283445be.js,sha256=FID-PRjvjbe_OHxm7L2NC92Cj_5V7AtDQ2WvKxLZ0lw,763
+unisi/web/js/430.591e9a73.js,sha256=7S1CJTwGdE2EKXzeFRcaYuTrn0QteoVI03Hykz8qh3s,6560
+unisi/web/js/app.ba94719f.js,sha256=Ye-ucwQNP-YLEUhE_wsS_3b6rIHvrPm8IUAPf5AH46A,5923
+unisi/web/js/vendor.d6797c01.js,sha256=2aKM3Lfxc0pHSirrcUReL1LcvDYWnfeBj2c67XsSELk,1279477
+unisi-0.1.0.dist-info/RECORD,,

unisi-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: pdm-backend (2.1.8)
+Root-Is-Purelib: true
+Tag: py3-none-any

unisi-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.