bazaar-contrib-sqlite 0.3.0rc1__py3-none-any.whl

bazaar_contrib_sqlite/resources/create_table.sql.tpl

@@ -0,0 +1,21 @@
+{% from "fragments.sql.tpl" import column_definition, predicate with context %}
+{% set table = operation.table %}
+CREATE {% if operation.temporary %}TEMPORARY {% endif %}TABLE {% if operation.if_not_exists %}IF NOT EXISTS {% endif %}{{ table.name | identifier }} (
+{% for column in table.columns %}
+    {{ column_definition(column) }}{% if not loop.last %},{% endif %}
+{% endfor %}
+{% if table.primary_key and not (table.columns | selectattr("generated") | list) %}
+    , PRIMARY KEY ({{ table.primary_key | map("identifier") | join(", ") }})
+{% endif %}
+{% for key in table.foreign_keys %}
+    , FOREIGN KEY ({{ key.columns | map("identifier") | join(", ") }})
+      REFERENCES {{ key.table | identifier }} ({{ key.references | map("identifier") | join(", ") }})
+      ON DELETE {{ key.on_delete | upper }}
+{% endfor %}
+{% for columns in table.unique %}
+    , UNIQUE ({{ columns | map("identifier") | join(", ") }})
+{% endfor %}
+{% for check in table.checks %}
+    , CHECK ({{ predicate(check) }})
+{% endfor %}
+)

bazaar_contrib_sqlite/resources/create_trigger.sql.tpl

@@ -0,0 +1,7 @@
+{% from "fragments.sql.tpl" import predicate with context %}
+CREATE TRIGGER {{ operation.name | identifier }} AFTER {{ operation.event | upper }} ON {{ operation.table | identifier }}
+{% if operation.when is not none %}WHEN {{ predicate(operation.when) }}{% endif %}
+BEGIN
+    {% set request = operation.action %}
+    {% include "update.sql.tpl" %};
+END

bazaar_contrib_sqlite/resources/delete.sql.tpl

@@ -0,0 +1,6 @@
+{% from "fragments.sql.tpl" import predicate, returning with context %}
+DELETE FROM {{ request.table | identifier }}
+{% if request.where is not none %}
+WHERE {{ predicate(request.where) }}
+{% endif %}
+{{ returning(request.returning) }}

bazaar_contrib_sqlite/resources/drop_column.sql.tpl

@@ -0,0 +1 @@
+ALTER TABLE {{ operation.table | identifier }} DROP COLUMN {{ operation.column | identifier }}

bazaar_contrib_sqlite/resources/drop_index.sql.tpl

@@ -0,0 +1 @@
+DROP INDEX {{ operation.name | identifier }}

bazaar_contrib_sqlite/resources/drop_table.sql.tpl

@@ -0,0 +1 @@
+DROP TABLE {% if operation.if_exists %}IF EXISTS {% endif %}{{ operation.table | identifier }}

bazaar_contrib_sqlite/resources/drop_trigger.sql.tpl

@@ -0,0 +1 @@
+DROP TRIGGER {% if operation.if_exists %}IF EXISTS {% endif %}{{ operation.name | identifier }}

bazaar_contrib_sqlite/resources/fragments.sql.tpl

@@ -0,0 +1,111 @@
+{% macro expression(node) -%}
+{% if node.kind == "column" %}
+    {% if node.table %}{{ node.table | identifier }}.{% endif %}{{ node.name | identifier }}
+{% elif node.kind == "row_id" %}
+    {% if node.table %}{{ node.table | identifier }}.{% endif %}rowid
+{% elif node.kind == "value" %}
+    {{ bind(node.value) }}
+{% elif node.kind == "binary" %}
+    ({{ expression(node.left) }} {{ node.operator }} {{ expression(node.right) }})
+{% elif node.kind == "row_number" %}
+    ROW_NUMBER() OVER (
+    {% if node.partition_by %}
+        PARTITION BY {% for value in node.partition_by %}{{ expression(value) }}{{ ", " if not loop.last else "" }}{% endfor %}
+    {% endif %}
+    ORDER BY
+    {% for sort in node.order_by %}
+        {{ expression(sort.expression) }} {{ "DESC" if sort.descending else "ASC" }} NULLS {{ sort.nulls | upper }}{{ ", " if not loop.last else "" }}
+    {% endfor %}
+    )
+{% elif node.kind == "case" %}
+    CASE WHEN {{ predicate(node.when) }} THEN {{ expression(node.then) }} ELSE {{ expression(node.otherwise) }} END
+{% elif node.kind == "subquery" %}
+    ({% with request=node.query %}{% include "select.sql.tpl" %}{% endwith %})
+{% elif node.kind == "call" %}
+    {{ node.name | upper }}(
+    {% for argument in node.arguments %}
+        {{ expression(argument) }}{{ ", " if not loop.last else "" }}
+    {% else %}
+        {% if node.name == "count" %}*{% endif %}
+    {% endfor %}
+    )
+{% endif %}
+{%- endmacro %}
+
+{% macro match_query(node, term) -%}
+{ {{ node.columns | join(" ") }} } : "{{ term | replace('"', '""') }}"
+{%- endmacro %}
+
+{% macro predicate(node) -%}
+{% if node.kind == "compare" %}
+    ({{ expression(node.left) }} {{ node.operator }} {{ expression(node.right) }})
+{% elif node.kind == "in" %}
+    {% if node.values %}
+        ({{ expression(node.expression) }} {% if node.exclude %}NOT {% endif %}IN (
+        {% for value in node.values %}
+            {{ bind(value) }}{{ ", " if not loop.last else "" }}
+        {% endfor %}
+        ))
+    {% else %}
+        {{ 1 if node.exclude else 0 }}
+    {% endif %}
+{% elif node.kind == "null" %}
+    ({{ expression(node.expression) }} IS {% if node.exclude %}NOT {% endif %}NULL)
+{% elif node.kind == "contains" %}
+    (instr(lower({{ expression(node.expression) }}), lower({{ bind(node.text) }})) > 0)
+{% elif node.kind in ("all", "any") %}
+    {% if node.conditions %}
+        (
+        {% for condition in node.conditions %}
+            {{ predicate(condition) }}
+            {% if not loop.last %}{{ "AND" if node.kind == "all" else "OR" }}{% endif %}
+        {% endfor %}
+        )
+    {% else %}
+        {{ 1 if node.kind == "all" else 0 }}
+    {% endif %}
+{% elif node.kind == "not" %}
+    (NOT {{ predicate(node.condition) }})
+{% elif node.kind == "search" %}
+    (
+    {% for term in node.terms %}
+        {% if term | length >= 3 %}
+            {{ node.table | identifier }}.{{ (node.row_key or "rowid") | identifier }} IN (
+                SELECT rowid FROM {{ node.index | identifier }}
+                WHERE {{ node.index | identifier }} MATCH {{ bind(match_query(node, term)) }}
+            )
+        {% else %}
+            (
+            {% for column in node.columns %}
+                instr(
+                    lower({{ node.table | identifier }}.{{ column | identifier }}),
+                    lower({{ bind(term) }})
+                ) > 0
+                {% if not loop.last %}OR{% endif %}
+            {% endfor %}
+            )
+        {% endif %}
+        {% if not loop.last %}AND{% endif %}
+    {% endfor %}
+    )
+{% endif %}
+{%- endmacro %}
+
+{% macro column_definition(column) -%}
+
+{{ column.name | identifier }} {{ column.type | upper }}
+{% if column.generated %}PRIMARY KEY AUTOINCREMENT{% endif %}
+{% if not column.nullable %}NOT NULL{% endif %}
+{% if column.default is not none %}DEFAULT {{ column.default | literal }}{% endif %}
+{% if column.unique %}UNIQUE{% endif %}
+{% if column.check is not none %}CHECK ({{ predicate(column.check) }}){% endif %}
+{% if column.references is not none %}
+REFERENCES {{ column.references.table | identifier }} ({{ column.references.column | identifier }}) ON DELETE {{ column.references.on_delete | upper }}
+{% endif %}
+{%- endmacro %}
+
+{% macro returning(columns) %}
+{% if columns %}
+RETURNING {{ columns | map("identifier") | join(", ") }}
+{% endif %}
+{% endmacro %}

bazaar_contrib_sqlite/resources/insert.sql.tpl

@@ -0,0 +1,23 @@
+{% from "fragments.sql.tpl" import returning %}
+{% set columns = request.rows[0].keys() | list %}
+INSERT INTO {{ request.table | identifier }} ({{ columns | map("identifier") | join(", ") }})
+VALUES
+{% for row in request.rows %}
+    (
+    {% for column in columns %}
+        {{ bind(row[column]) }}{{ ", " if not loop.last else "" }}
+    {% endfor %}
+    ){{ ", " if not loop.last else "" }}
+{% endfor %}
+{% if request.conflict is not none %}
+ON CONFLICT ({{ request.conflict.columns | map("identifier") | join(", ") }})
+{% if request.conflict.update %}
+DO UPDATE SET
+{% for column in request.conflict.update %}
+    {{ column | identifier }} = excluded.{{ column | identifier }}{% if not loop.last %},{% endif %}
+{% endfor %}
+{% else %}
+DO NOTHING
+{% endif %}
+{% endif %}
+{{ returning(request.returning) }}

bazaar_contrib_sqlite/resources/rename_column.sql.tpl

@@ -0,0 +1 @@
+ALTER TABLE {{ operation.table | identifier }} RENAME COLUMN {{ operation.column | identifier }} TO {{ operation.name | identifier }}

bazaar_contrib_sqlite/resources/rename_table.sql.tpl

@@ -0,0 +1 @@
+ALTER TABLE {{ operation.table | identifier }} RENAME TO {{ operation.name | identifier }}

bazaar_contrib_sqlite/resources/search_delete.sql.tpl

@@ -0,0 +1,8 @@
+CREATE TRIGGER {{ (operation.index.name ~ "_ad") | identifier }}
+AFTER DELETE ON {{ operation.table | identifier }}
+BEGIN
+    INSERT INTO {{ operation.index.name | identifier }}
+        ({{ operation.index.name | identifier }}, rowid, {{ operation.index.columns | map("identifier") | join(", ") }})
+    VALUES
+        ('delete', old.{{ (operation.index.row_key or "rowid") | identifier }}, {% for column in operation.index.columns %}old.{{ column | identifier }}{% if not loop.last %}, {% endif %}{% endfor %});
+END

bazaar_contrib_sqlite/resources/search_insert.sql.tpl

@@ -0,0 +1,8 @@
+CREATE TRIGGER {{ (operation.index.name ~ "_ai") | identifier }}
+AFTER INSERT ON {{ operation.table | identifier }}
+BEGIN
+    INSERT INTO {{ operation.index.name | identifier }}
+        (rowid, {{ operation.index.columns | map("identifier") | join(", ") }})
+    VALUES
+        (new.{{ (operation.index.row_key or "rowid") | identifier }}, {% for column in operation.index.columns %}new.{{ column | identifier }}{% if not loop.last %}, {% endif %}{% endfor %});
+END

bazaar_contrib_sqlite/resources/search_rebuild.sql.tpl

@@ -0,0 +1,2 @@
+INSERT INTO {{ operation.index.name | identifier }} ({{ operation.index.name | identifier }})
+VALUES ('rebuild')

bazaar_contrib_sqlite/resources/search_table.sql.tpl

@@ -0,0 +1,7 @@
+CREATE VIRTUAL TABLE {{ operation.index.name | identifier }}
+USING fts5(
+    {{ operation.index.columns | map("identifier") | join(", ") }},
+    content={{ operation.table | literal }},
+    content_rowid={{ (operation.index.row_key or "rowid") | literal }},
+    tokenize='trigram'
+)

bazaar_contrib_sqlite/resources/search_update.sql.tpl

@@ -0,0 +1,12 @@
+CREATE TRIGGER {{ (operation.index.name ~ "_au") | identifier }}
+AFTER UPDATE ON {{ operation.table | identifier }}
+BEGIN
+    INSERT INTO {{ operation.index.name | identifier }}
+        ({{ operation.index.name | identifier }}, rowid, {{ operation.index.columns | map("identifier") | join(", ") }})
+    VALUES
+        ('delete', old.{{ (operation.index.row_key or "rowid") | identifier }}, {% for column in operation.index.columns %}old.{{ column | identifier }}{% if not loop.last %}, {% endif %}{% endfor %});
+    INSERT INTO {{ operation.index.name | identifier }}
+        (rowid, {{ operation.index.columns | map("identifier") | join(", ") }})
+    VALUES
+        (new.{{ (operation.index.row_key or "rowid") | identifier }}, {% for column in operation.index.columns %}new.{{ column | identifier }}{% if not loop.last %}, {% endif %}{% endfor %});
+END

bazaar_contrib_sqlite/resources/select.sql.tpl

@@ -0,0 +1,44 @@
+{% from "fragments.sql.tpl" import expression, predicate with context %}
+{% if request.ctes %}
+WITH
+{% for name, query in request.ctes.items() %}
+{{ name | identifier }} AS (
+{% with request=query %}{% include "select.sql.tpl" %}{% endwith %}
+){% if not loop.last %},{% endif %}
+{% endfor %}
+{% endif %}
+SELECT {% if request.distinct %}DISTINCT {% endif %}
+{% for alias, value in request.columns.items() %}
+    {{ expression(value) }} AS {{ alias | identifier }}{% if not loop.last %},{% endif %}
+{% else %}
+    *
+{% endfor %}
+FROM {{ request.table | identifier }}{% if request.alias %} AS {{ request.alias | identifier }}{% endif %}
+
+{% for join in request.joins %}
+{{ join.kind | upper }} JOIN {{ join.table | identifier }}{% if join.alias %} AS {{ join.alias | identifier }}{% endif %}
+
+    ON {{ predicate(join.on) }}
+{% endfor %}
+{% if request.where is not none %}
+WHERE {{ predicate(request.where) }}
+{% endif %}
+{% if request.group_by %}
+GROUP BY {% for value in request.group_by %}{{ expression(value) }}{% if not loop.last %}, {% endif %}{% endfor %}
+
+{% endif %}
+{% if request.having is not none %}
+HAVING {{ predicate(request.having) }}
+{% endif %}
+{% if request.order_by %}
+ORDER BY
+{% for item in request.order_by %}
+    {{ expression(item.expression) }} {{ "DESC" if item.descending else "ASC" }} NULLS {{ item.nulls | upper }}{% if not loop.last %},{% endif %}
+{% endfor %}
+{% endif %}
+{% if request.limit is not none or request.offset %}
+LIMIT {{ bind(request.limit if request.limit is not none else -1) }}
+{% endif %}
+{% if request.offset %}
+OFFSET {{ bind(request.offset) }}
+{% endif %}

bazaar_contrib_sqlite/resources/update.sql.tpl

@@ -0,0 +1,10 @@
+{% from "fragments.sql.tpl" import expression, predicate, returning with context %}
+UPDATE {{ request.table | identifier }}
+SET
+{% for column, value in request.values.items() %}
+    {{ column | identifier }} = {{ expression(value) }}{% if not loop.last %},{% endif %}
+{% endfor %}
+{% if request.where is not none %}
+WHERE {{ predicate(request.where) }}
+{% endif %}
+{{ returning(request.returning) }}

bazaar_contrib_sqlite-0.3.0rc1.dist-info/METADATA

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: bazaar-contrib-sqlite
+Version: 0.3.0rc1
+Summary: SQLite implementation of the shared storage contract
+License-Expression: Apache-2.0
+License-File: LICENSE
+Requires-Dist: bazaar-core~=0.3.0rc1
+Requires-Dist: bazaar-contrib-storage~=0.3.0rc1
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: pydantic>=2.12.0
+Requires-Dist: jinja2>=3.1.6
+Requires-Python: >=3.15
+Project-URL: Repository, https://github.com/yuchanns/bazaar-compute-node
+Description-Content-Type: text/markdown
+
+# bazaar-contrib-sqlite
+
+Store node data in SQLite. Enable `storage` and select its `database` entry with `backend = "sqlite"`.
+
+```sh
+bcn contrib add sqlite --enable
+```
+
+The corresponding entry in `config.toml`:
+
+```toml
+version = "5"
+
+[[contribs]]
+package = "bazaar-contrib-sqlite~=0.3.0rc1"
+[[contribs.enabled]]
+entry = "sqlite"
+[contribs.enabled.config]
+path = "/path/to/node.db"
+```

bazaar_contrib_sqlite-0.3.0rc1.dist-info/RECORD

@@ -0,0 +1,32 @@
+bazaar_contrib_sqlite/__init__.py,sha256=ohbeO0DNxDAJebkLNjPHKKMC1oAL0wcq1WBwHbQdafI,751
+bazaar_contrib_sqlite/compiler.py,sha256=Wd5AvyL_uEjsdwduhi5JR9lwE57jrUA1N9Ld409v5S0,2328
+bazaar_contrib_sqlite/database.py,sha256=JhGuzK080iA9jOlBaRLLmSfE4lntSldUR5T3z8DlyU0,12700
+bazaar_contrib_sqlite/executor.py,sha256=k-7eHtcvyzhIjx3Lw-ty4LrJ1pbc6_jhnw0_bEGWfEs,23610
+bazaar_contrib_sqlite/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+bazaar_contrib_sqlite/resources/add_column.sql.tpl,sha256=Antc3JRsHXmGspVyvjbRYgIMljc9L7ZvnU-DTYQ4d1Q,169
+bazaar_contrib_sqlite/resources/busy_timeout.sql.tpl,sha256=vW9sREt6cSWWfy-otpf0-iwZBp30_LBTJkqjSboBHDg,36
+bazaar_contrib_sqlite/resources/copy.sql.tpl,sha256=eAuWd3-8B4qil-8G1uqTEHwJEEGKuuv2JDm-JoXm9v4,173
+bazaar_contrib_sqlite/resources/create_index.sql.tpl,sha256=EJRkD16jE4VHZuOAwAG6OKwWpH9jNsIa39O5zanEIdg,696
+bazaar_contrib_sqlite/resources/create_table.sql.tpl,sha256=hqH_9XNmf3kmOzp2M8IzLs0W5Q7CTlfyn3ssVTj5BAw,1014
+bazaar_contrib_sqlite/resources/create_trigger.sql.tpl,sha256=HD2uWBiw8djHwFIF1Wozd7xN9H9DQ-UYM0iNHjhDv8k,354
+bazaar_contrib_sqlite/resources/delete.sql.tpl,sha256=IG-KpV8VoYqwwKO44lZ9ahBjeIlBZXZFhZyMloJoG2k,236
+bazaar_contrib_sqlite/resources/drop_column.sql.tpl,sha256=WTcf80YCNhqn3qgiAEQi7nv3ZkiNEA8ynjR4Su56Cbo,95
+bazaar_contrib_sqlite/resources/drop_index.sql.tpl,sha256=Qhmpo3evAN0UEkE765cQAm0VN_T6PIsshHFdEmbQscI,45
+bazaar_contrib_sqlite/resources/drop_table.sql.tpl,sha256=OFma7bASRv3JOmVMnW2_UBNFB6E-UvXNeKXQpxdFgfk,95
+bazaar_contrib_sqlite/resources/drop_trigger.sql.tpl,sha256=jrTBT3D2kTgjgTIcQKKXfDonIkU6adTF-AO9BlVLGAA,96
+bazaar_contrib_sqlite/resources/fragments.sql.tpl,sha256=GuGgCnmG38lFZ3EiWTVDhBDWGWRJAU6ouAj9AANLX7o,4320
+bazaar_contrib_sqlite/resources/insert.sql.tpl,sha256=bND7hA2qFHTEb4FmGlBaQ7n1Zg6iIKjd0F-mxZegZPs,807
+bazaar_contrib_sqlite/resources/rename_column.sql.tpl,sha256=AA1ntP4rFL7rgPRYufvxnMsiusyFWXn2edaoW3TidNU,134
+bazaar_contrib_sqlite/resources/rename_table.sql.tpl,sha256=54TeLbU3Kq8jYX8x4mhRBthsHi5i7QMcRjawJ2JH5sw,91
+bazaar_contrib_sqlite/resources/search_delete.sql.tpl,sha256=gOj3Z_LLiE9u-ibJKvvM2PCMnXjtZUpCdUnwyreGv54,516
+bazaar_contrib_sqlite/resources/search_insert.sql.tpl,sha256=5Oz3l_kUbmJMWuU5BvVG5Rx1hIOB8ng2P-Sr6zThlHg,465
+bazaar_contrib_sqlite/resources/search_rebuild.sql.tpl,sha256=JDPvnYZbp4g3w3jx03514ctN2MgYm-ogUBiqB44AkC8,113
+bazaar_contrib_sqlite/resources/search_table.sql.tpl,sha256=AeVXipAQEF0SCiFIPRdHQzdMwMIeHBL8j1obJkd0Tcw,283
+bazaar_contrib_sqlite/resources/search_update.sql.tpl,sha256=ZaYe7FNRPsHg19ftfGg_f4X4ZzpWjjl_NvO6jQro7o8,855
+bazaar_contrib_sqlite/resources/select.sql.tpl,sha256=bIUhAmGsFqL1MeBz8VNgh2hjrMdnPvDL0se3W3s5Hd8,1605
+bazaar_contrib_sqlite/resources/update.sql.tpl,sha256=Q9LeDcWeBk0ZWwdvZARbDZB_806aVF3NPDctILmivz8,400
+bazaar_contrib_sqlite-0.3.0rc1.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+bazaar_contrib_sqlite-0.3.0rc1.dist-info/WHEEL,sha256=xTCBFIZIIyRSxyowOv5Wqg_jFU6KsdIffuulBB09Ph8,80
+bazaar_contrib_sqlite-0.3.0rc1.dist-info/entry_points.txt,sha256=A3tedEy8b--Rv-5vQ5LVsDaNX7Oq0IQ5rBqveHkw4bA,70
+bazaar_contrib_sqlite-0.3.0rc1.dist-info/METADATA,sha256=4aQv_aBBfZkvQKUzHOKHpvbicDpsp5_fFO8X1UBV6Jo,889
+bazaar_contrib_sqlite-0.3.0rc1.dist-info/RECORD,,

bazaar_contrib_sqlite-0.3.0rc1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.13.0
+Root-Is-Purelib: true
+Tag: py3-none-any

bazaar_contrib_sqlite-0.3.0rc1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[bazaar_compute_node.contribs]
+sqlite = bazaar_contrib_sqlite:sqlite
+

bazaar_contrib_sqlite-0.3.0rc1.dist-info/licenses/LICENSE

@@ -0,0 +1,202 @@
+
+                                 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.