datafun-streaming 0.1.0__py3-none-any.whl

datafun_streaming/storage/duckdb_utils.py

@@ -0,0 +1,244 @@
+"""src/datafun_streaming/storage/duckdb_utils.py.
+
+DuckDB utilities for streaming data.
+
+Provides functions to initialize, write to, query, and close
+a DuckDB database from a streaming consumer.
+
+This is domain-agnostic: it works with any table name and any row dict.
+Tables are created automatically from the first row received.
+Schema is inferred from Python value types.
+
+Author: Denise Case
+Date: 2026-05
+"""
+
+# === IMPORTS ===
+
+import logging
+from pathlib import Path
+from typing import Any
+
+import duckdb
+
+# === DECLARE EXPORTS
+
+__all__ = [
+    "connect_to_database",
+    "init_db",
+    "close_db",
+    "upsert_row",
+    "query_db",
+    "safe_table_name",
+]
+
+# === CONFIGURE LOGGER ===
+
+LOG = logging.getLogger(__name__)
+
+# === TYPE MAP: Python types to DuckDB column types ===
+
+_DUCKDB_TYPE_MAP: dict[type, str] = {
+    str: "VARCHAR",
+    int: "INTEGER",
+    float: "DOUBLE",
+    bool: "BOOLEAN",
+}
+
+# === DECLARE SQL-SAFE TABLE NAMES ===
+
+_ALLOWED_TABLE_NAMES: frozenset[str] = frozenset(
+    {
+        "valid_table",
+        "rejected_table",
+    }
+)
+
+
+# === DEFINE FUNCTIONS ===
+
+
+def connect_to_database(database_file_path: Path) -> duckdb.DuckDBPyConnection:
+    """Connect to the DuckDB database file.
+
+    Arguments:
+        database_file_path: Path to the DuckDB database file.
+
+    Returns:
+        An open DuckDB connection.
+    """
+    return duckdb.connect(str(database_file_path))
+
+
+def close_db(conn: duckdb.DuckDBPyConnection) -> None:
+    """Close a DuckDB connection.
+
+    Arguments:
+        conn: An open DuckDB connection.
+
+    Returns:
+        None.
+    """
+    conn.close()
+    LOG.debug("DuckDB connection closed.")
+
+
+def init_db(path: Path) -> duckdb.DuckDBPyConnection:
+    """Open or create a DuckDB database at the given path.
+
+    If the file already exists it is opened and reused.
+    If it does not exist it is created.
+
+    Arguments:
+        path: File path for the DuckDB database (e.g. data/output/sales.duckdb).
+
+    Returns:
+        An open DuckDB connection.
+    """
+    path.parent.mkdir(parents=True, exist_ok=True)
+    conn = duckdb.connect(str(path))
+    LOG.debug(f"DuckDB opened: {path}")
+    return conn
+
+
+def safe_table_name(table_name: str, allowed: frozenset[str]) -> str:
+    """Return table_name after confirming it is in the allowed list.
+
+    SQL identifiers (table names, column names) cannot use parameterized
+    query placeholders. This allowlist check prevents accidental injection
+    if a caller passes an unexpected string.
+
+    Arguments:
+        table_name: The table name to validate.
+        allowed: A frozenset of allowed table names.
+
+    Returns:
+        The validated table name, unchanged.
+
+    Raises:
+        ValueError: If table_name is not in the allowed list.
+    """
+    if table_name not in allowed:
+        raise ValueError(
+            f"Table name {table_name!r} is not in the allowed list. "
+            f"Allowed: {sorted(allowed)}"
+        )
+    return table_name
+
+
+def query_db(
+    conn: duckdb.DuckDBPyConnection,
+    sql: str,
+    params: list[Any] | None = None,
+) -> list[dict[str, Any]]:
+    """Execute a SQL query and return results as a list of dicts.
+
+    Arguments:
+        conn:   Open DuckDB connection.
+        sql:    SQL query string. Use ? for parameter placeholders.
+        params: Optional list of parameter values for placeholders.
+
+    Returns:
+        A list of row dicts. Empty list if no rows matched.
+
+    Example:
+        rows = query_db(conn, "SELECT * FROM sales WHERE region_id = ?", ["US-MO"])
+    """
+    result = conn.execute(sql, params or [])
+    columns = [desc[0] for desc in result.description]
+    return [dict(zip(columns, row, strict=False)) for row in result.fetchall()]
+
+
+def upsert_row(
+    conn: duckdb.DuckDBPyConnection,
+    *,
+    table: str,
+    row: dict[str, Any],
+    primary_key: str,
+    allowed_tables: frozenset[str],  # ← caller provides this
+) -> None:
+    """Insert or replace one row in a DuckDB table.
+
+    Creates the table on the first call if it does not exist.
+    On subsequent calls with the same primary key value,
+    the existing row is replaced with the new values.
+
+    Arguments:
+        conn:        Open DuckDB connection.
+        *: All arguments after the asterisk must be passed as keyword arguments.
+        table:       Table name to write to.
+        row:         The row to insert or replace.
+        primary_key: The field name that uniquely identifies each row.
+        allowed_tables: A frozenset of allowed table names.
+
+    Returns:
+        None.
+    """
+    # Validate before use: table name must be in the allowlist,
+    # primary key must be a field in the row.
+    safe = safe_table_name(table, allowed_tables)
+    safe_pk = safe_table_name(primary_key, frozenset(row.keys()))
+
+    # Pass the validated names so _ensure_table never receives raw input.
+    _ensure_table(conn, safe, row, safe_pk)
+
+    pk_value = row[safe_pk]
+    conn.execute(
+        f"DELETE FROM {safe} WHERE {safe_pk} = ?",  # noqa: S608 - identifiers validated via safe_table_name allowlist
+        [pk_value],
+    )
+
+    cols = ", ".join(row.keys())
+    placeholders = ", ".join(["?"] * len(row))
+    conn.execute(
+        f"INSERT INTO {safe} ({cols}) VALUES ({placeholders})",  # noqa: S608 - identifiers validated via safe_table_name allowlist
+        list(row.values()),
+    )
+    LOG.debug(f"Upserted row into {safe} with primary key {safe_pk}={pk_value}")
+
+
+# == DEFINE INTERNAL HELPER FUNCTIONS (not exported) ===
+
+
+def _ensure_table(
+    conn: duckdb.DuckDBPyConnection,
+    table: str,
+    row: dict[str, Any],
+    primary_key: str,
+) -> None:
+    """Create the table if it does not already exist.
+
+    Infers column types from the Python types of the row values.
+    The primary key column is marked as PRIMARY KEY.
+
+    Arguments:
+        conn:        Open DuckDB connection.
+        table:       Table name to create.
+        row:         A representative row dict used for schema inference.
+        primary_key: The field name to use as the primary key.
+
+    Returns:
+        None.
+    """
+    columns = []
+    for col, val in row.items():
+        col_type = _infer_column_type(val)
+        if col == primary_key:
+            columns.append(f"{col} {col_type} PRIMARY KEY")
+        else:
+            columns.append(f"{col} {col_type}")
+
+    col_defs = ", ".join(columns)
+    conn.execute(f"CREATE TABLE IF NOT EXISTS {table} ({col_defs})")  # noqa: S608 - identifiers validated via safe_table_name allowlist
+
+
+def _infer_column_type(value: Any) -> str:
+    """Infer a DuckDB column type from a Python value.
+
+    Arguments:
+        value: A Python value whose type will be inspected.
+
+    Returns:
+        A DuckDB type string (e.g. "VARCHAR", "DOUBLE").
+    """
+    return _DUCKDB_TYPE_MAP.get(type(value), "VARCHAR")

datafun_streaming/visualization/__init__.py

@@ -0,0 +1 @@
+"""Utilities for visualizing streaming data."""

datafun_streaming/visualization/chart_utils.py

@@ -0,0 +1,150 @@
+"""src/datafun_streaming/visualization/chart_utils.py.
+
+Chart utilities for streaming data.
+
+Provides functions to create, update, and save a line chart
+that accumulates data points as messages are consumed.
+
+Uses Plotly to generate an interactive HTML chart.
+The chart is updated in memory as each message arrives
+and saved to disk at the end of the consume loop (Section C4).
+
+This is domain-agnostic: pass any numeric field and any label.
+The chart does not know what it is charting.
+
+Author: Denise Case
+Date: 2026-05
+"""
+
+# === IMPORTS ===
+
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
+
+import plotly.graph_objects as go
+
+# === EXPORTS ===
+
+__all__ = [
+    "StreamingChart",
+    "init_chart",
+    "update_chart",
+    "save_chart",
+]
+
+# === DEFINE CHART DATA CLASS ===
+
+
+@dataclass
+class StreamingChart:
+    """Holds chart state for a single line series.
+
+    Updated incrementally as messages arrive.
+    Rendered to HTML when save_chart() is called.
+
+    Attributes:
+        title:    Chart title shown at the top.
+        x_label:  Label for the x-axis.
+        y_label:  Label for the y-axis.
+        x_values: Accumulated x-axis values (e.g. message count).
+        y_values: Accumulated y-axis values (e.g. running total).
+    """
+
+    title: str
+    x_label: str
+    y_label: str
+    x_values: list[int | float | str] = field(default_factory=list)
+    y_values: list[float] = field(default_factory=list)
+
+    @property
+    def is_empty(self) -> bool:
+        """Return True if no data points have been added yet."""
+        return len(self.x_values) == 0
+
+
+# === DEFINE CHART FUNCTIONS ===
+
+
+def init_chart(
+    *,
+    title: str,
+    x_label: str,
+    y_label: str,
+) -> StreamingChart:
+    """Create a new empty StreamingChart.
+
+    Arguments:
+        title:   Chart title.
+        x_label: Label for the x-axis.
+        y_label: Label for the y-axis.
+
+    Returns:
+        An empty StreamingChart ready to receive data points.
+    """
+    return StreamingChart(title=title, x_label=x_label, y_label=y_label)
+
+
+def update_chart(
+    chart: StreamingChart,
+    row: dict[str, Any],
+    *,
+    x_field: str = "_kafka_offset",
+    y_field: str = "total",
+) -> None:
+    """Add one data point to the chart from a message row.
+
+    Arguments:
+        chart:   The StreamingChart to update.
+        row:     The enriched message row.
+        x_field: The row field to use as the x-axis value.
+                 Defaults to _kafka_offset (message sequence number).
+        y_field: The row field to use as the y-axis value.
+                 Defaults to total (post-tax total price).
+
+    Returns:
+        None.
+    """
+    x_value = row.get(x_field, len(chart.x_values))
+    y_value = row.get(y_field, 0.0)
+
+    chart.x_values.append(x_value)
+    chart.y_values.append(float(y_value))
+
+
+def save_chart(chart: StreamingChart, path: Path) -> None:
+    """Render the chart to an interactive HTML file.
+
+    Arguments:
+        chart: The StreamingChart to render.
+        path:  Output file path. Must end in .html.
+
+    Returns:
+        None.
+    """
+    if chart.is_empty:
+        return
+
+    fig = go.Figure()
+
+    fig.add_trace(
+        go.Scatter(
+            x=chart.x_values,
+            y=chart.y_values,
+            mode="lines+markers",
+            name=chart.y_label,
+            line={"width": 2},
+            marker={"size": 4},
+        )
+    )
+
+    fig.update_layout(
+        title=chart.title,
+        xaxis_title=chart.x_label,
+        yaxis_title=chart.y_label,
+        hovermode="x unified",
+        template="plotly_white",
+    )
+
+    path.parent.mkdir(parents=True, exist_ok=True)
+    fig.write_html(str(path))

datafun_streaming-0.1.0.dist-info/METADATA

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: datafun-streaming
+Version: 0.1.0
+Summary: Utilities for streaming data analytics with Kafka and DuckDB.
+Project-URL: Homepage, https://github.com/denisecase/datafun-streaming
+Project-URL: Repository, https://github.com/denisecase/datafun-streaming
+Project-URL: Documentation, https://denisecase.github.io/datafun-streaming/
+Project-URL: Issues, https://github.com/denisecase/datafun-streaming/issues
+Project-URL: Changelog, https://github.com/denisecase/datafun-streaming/blob/main/CHANGELOG.md
+Author-email: Denise Case <dcase@nwmissouri.edu>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: confluent-kafka,data-analytics,data-validation,running-statistics,streaming-data
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Requires-Dist: confluent-kafka
+Requires-Dist: datafun-toolkit
+Requires-Dist: duckdb
+Requires-Dist: plotly
+Requires-Dist: python-dotenv
+Provides-Extra: dev
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pyright; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocstrings[python]; extra == 'docs'
+Requires-Dist: zensical; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# datafun-streaming
+
+[![Adaptive Interfaces](https://img.shields.io/badge/adaptive--interfaces-schema-blue?logo=github)](https://github.com/denisecase)
+[![PyPI](https://img.shields.io/pypi/v/datafun-streaming?logo=pypi&label=pypi)](https://pypi.org/project/datafun-streaming/)
+[![Docs Site](https://img.shields.io/badge/docs-site-blue?logo=github)](https://denisecase.github.io/datafun-streaming/)
+[![Repo](https://img.shields.io/badge/repo-GitHub-black?logo=github)](https://github.com/denisecase/datafun-streaming)
+[![Python 3.15+](https://img.shields.io/badge/python-3.15%2B-blue?logo=python)](https://github.com/denisecase/datafun-streaming/blob/main/pyproject.toml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+[![CI](https://github.com/denisecase/datafun-streaming/actions/workflows/ci-python-zensical.yml/badge.svg?branch=main)](https://github.com/denisecase/datafun-streaming/actions/workflows/ci-python-zensical.yml)
+[![Docs](https://github.com/denisecase/datafun-streaming/actions/workflows/deploy-zensical.yml/badge.svg?branch=main)](https://github.com/denisecase/datafun-streaming/actions/workflows/deploy-zensical.yml)
+[![Links](https://github.com/denisecase/datafun-streaming/actions/workflows/links.yml/badge.svg?branch=main)](https://github.com/denisecase/datafun-streaming/actions/workflows/links.yml)
+
+> Shared Python utilities for Kafka, DuckDB, validation, stats, and visualization
+> across streaming data analytics projects.
+
+## Command Reference
+
+<details>
+<summary>Show command reference</summary>
+
+### In a machine terminal
+
+Open a machine terminal where you want the project:
+
+```shell
+git clone https://github.com/denisecase/datafun-streaming
+
+cd datafun-streaming
+code .
+```
+
+### In a VS Code terminal
+
+```shell
+# reset uv cache only after suspected cache corruption or strange dependency errors
+# uv cache clean
+
+uv self update
+uv python pin 3.14
+uv sync --extra dev --extra docs --upgrade
+
+uvx pre-commit install
+
+git add -A
+uvx pre-commit run --all-files
+# repeat if changes were made
+git add -A
+uvx pre-commit run --all-files
+
+# do chores
+uv run python -m ruff format .
+uv run python -m ruff check . --fix
+uv run python -m pyright
+uv run python -m pytest
+uv run python -m zensical build
+
+# save progress
+git add -A
+git commit -m "update"
+git push -u origin main
+```
+
+</details>
+
+## Notes
+
+- Use the **UP ARROW** and **DOWN ARROW** in the terminal to scroll through past commands.
+- Use `CTRL+f` to find (and replace) text within a file.
+- You do not need to add to or modify `tests/`. They are provided for example only.
+- Many files are silent helpers. Explore as you like, but nothing is required.
+- You do NOT not to understand everything; understanding builds naturally over time.
+
+## Troubleshooting >>> or
+
+If you see something like this in your terminal: `>>>` or `...`
+You accidentally started Python interactive mode.
+It happens.
+Press `Ctrl+c` (both keys together) or `Ctrl+Z` then `Enter` on Windows.
+
+## Example Output
+
+```shell
+| INFO | P01 | ========================
+| INFO | P01 | START main()
+| INFO | P01 | ========================
+| INFO | P01 | ROOT_DIR = .
+| INFO | P01 | DATA_DIR = data
+| INFO | P01 | OUTPUT_CSV = data\sales.csv
+| INFO | P01 | Streaming 3 sales to C:\Repos\streaming\datafun-streaming\data\sales.csv ...
+| INFO | P01 | Watch each sale arrive. Press CTRL+C to stop early.
+
+| INFO | P01 | (1, 81.87, 'Backpack', 'East')
+| INFO | P01 | Generated formatted multi-line SUMMARY string.
+| INFO | P01 | Returning the str to the calling function.
+| INFO | P01 |
+    Descriptive Statistics for Streaming Sales Amounts ($):
+        Count of sales   : 1
+        Minimum sale     : $81.87
+        Maximum sale     : $81.87
+        Average sale     : $81.87
+        Standard deviation: $0.00
+
+| INFO | P01 | (2, 101.58, 'Water Bottle', 'North')
+| INFO | P01 | Generated formatted multi-line SUMMARY string.
+| INFO | P01 | Returning the str to the calling function.
+| INFO | P01 |
+    Descriptive Statistics for Streaming Sales Amounts ($):
+        Count of sales   : 2
+        Minimum sale     : $81.87
+        Maximum sale     : $101.58
+        Average sale     : $91.72
+        Standard deviation: $13.94
+
+| INFO | P01 | (3, 27.15, 'Running Shoes', 'East')
+| INFO | P01 | Generated formatted multi-line SUMMARY string.
+| INFO | P01 | Returning the str to the calling function.
+| INFO | P01 |
+    Descriptive Statistics for Streaming Sales Amounts ($):
+        Count of sales   : 3
+        Minimum sale     : $27.15
+        Maximum sale     : $101.58
+        Average sale     : $70.20
+        Standard deviation: $38.56
+
+| INFO | P01 | ========================
+| INFO | P01 | Producer executed successfully!
+| INFO | P01 | ========================
+```

datafun_streaming-0.1.0.dist-info/RECORD

@@ -0,0 +1,30 @@
+datafun_streaming/__init__.py,sha256=fWc236jQhyvJ_PJQdxZtZ5n750F5Toj4qIMX6__xHgg,83
+datafun_streaming/_version.py,sha256=n_5vdJsPNu7wZ57LGuRL585uvll-hiuvZUBWzdG0RQU,520
+datafun_streaming/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+datafun_streaming/core/__init__.py,sha256=q_nZswj8VsvIVjHUKRCI4RE0djGcuf9Gtkodcmz-Z8g,25
+datafun_streaming/core/types.py,sha256=HDdIFHEheXcihYJqmuAcfGjJiihn0y1bpsBAhOh7v0M,419
+datafun_streaming/data_validation/__init__.py,sha256=4T0-MWVJSJ3NoVbaqe7pVYeZvhkWyLeaSvuqvISNjfU,84
+datafun_streaming/data_validation/errors.py,sha256=zepbDg8YoPYUaPddqDfkuOaukD6YXRT49cxgYWAoT8s,758
+datafun_streaming/data_validation/reference.py,sha256=BpEYMQxFvcIm7pzeu8iE8TS8pB-F7scLjovtK1cK8xE,1914
+datafun_streaming/data_validation/types.py,sha256=OJL35s0TLl3w-8BYJhaLrXACaCjT229nzqkxU1kNgFk,921
+datafun_streaming/data_validation/validation_utils.py,sha256=dU6SPNEld2ConD9L_N0ahVrf5sHmdSehIXhhNB8n_Eg,3889
+datafun_streaming/io/__init__.py,sha256=T5cpnhwM00xH-kAQen_rQjVtY-Q_jpbnEbXUl2wz524,63
+datafun_streaming/io/errors.py,sha256=FtrooZTpv3ppzuQbLbSEEWs2cfNiTaNs4CRE-rGyfS8,1187
+datafun_streaming/io/io_utils.py,sha256=sL4oDfwHhSfRKoXuHcII4MrFAVxwWy1W28yvc9AFu_o,2882
+datafun_streaming/kafka/__init__.py,sha256=xbhP9Kt6Gu6rVewpG9TyLflpEymPrK2u92aUWxo_xCw,65
+datafun_streaming/kafka/errors.py,sha256=nAQU5-hNHlFlhB8VMaU0E1SmEiWLV-suEkTvyJa45LY,4511
+datafun_streaming/kafka/kafka_admin_utils.py,sha256=WEHlAvzpLIAjpQDYrHH_ZozVkdMbn2x1r3-Z2vTrxBQ,6183
+datafun_streaming/kafka/kafka_connection_utils.py,sha256=XhO9SU2_HVPaABJgqEky3U-6JG3mdeRbfIPf_mqZQQc,1297
+datafun_streaming/kafka/kafka_consumer_utils.py,sha256=rDynWwpL4fOaHZGI46jdxNOLPU5ZFIrYGuhC0oVpI54,1456
+datafun_streaming/kafka/kafka_producer_utils.py,sha256=6MAIUpGd8qtPIJbtKA1DIdfSbLC9nBb8ntmbB7unik0,2489
+datafun_streaming/kafka/kafka_settings.py,sha256=f4rX8G7OSCcFUnG8qLQ7QRkaalLKUeHgq3HO9Jh5z7A,2108
+datafun_streaming/stats/__init__.py,sha256=njpyz4wW4oDhx_XYP-ETRoSPPhzf8EQqqh9FdK500tA,57
+datafun_streaming/stats/stats_utils.py,sha256=uUHQqsUogof4_Kubm4sZLZBaw35yfnBq18jA-SfmK8g,2928
+datafun_streaming/storage/__init__.py,sha256=Iqv6QCzUnEkYCR7Kf1edqU5jP9Oa6mh3HqmmTLI93No,47
+datafun_streaming/storage/duckdb_utils.py,sha256=3es14fNzXsRT5K7IxHjfB2csK3Hu3-K-Xu0PkmgrR5o,6787
+datafun_streaming/visualization/__init__.py,sha256=mBLBuDKyEI1DqzvqbQ5F0Cu7kzfF9LQ2ChfpJQRLkiA,48
+datafun_streaming/visualization/chart_utils.py,sha256=q1jMh0835uM1LzorNWvSXpi4fUsz5ikUrEi9D-CUkFk,3676
+datafun_streaming-0.1.0.dist-info/METADATA,sha256=V8hlav5pf51c3Yfsg3rdhYVXBUaMygqZGeBeY43EfXE,6427
+datafun_streaming-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+datafun_streaming-0.1.0.dist-info/licenses/LICENSE,sha256=Xs6IcjtQ_6V_-e6sSH0xOsGwgZ1zwlqOz12Tx4VMXvU,1068
+datafun_streaming-0.1.0.dist-info/RECORD,,

datafun_streaming-0.1.0.dist-info/WHEEL

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

datafun_streaming-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Denise Case
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.