bocai-cli-core 0.2.0__py3-none-any.whl

bocai_cli/commands/report.py

@@ -0,0 +1,93 @@
+from __future__ import annotations
+
+import typer
+
+from bocai_cli.api import ApiFacade
+from bocai_cli.command_utils import command_handler
+from bocai_cli.config import load_config
+from bocai_cli.date_range_validation import validate_optional_date_range
+from bocai_cli.output import print_json
+
+app = typer.Typer(help="report相关命令。", invoke_without_command=True)
+
+
+@app.callback()
+def report_root(ctx: typer.Context) -> None:
+    if ctx.invoked_subcommand is None:
+        typer.echo(ctx.get_help())
+        raise typer.Exit(code=0)
+
+
+def _build_api() -> ApiFacade:
+    config = load_config()
+    return ApiFacade(
+        base_url=config.base_url,
+        token=config.token,
+        timeout_seconds=config.timeout_seconds,
+    )
+
+
+@app.command("revenue", help="获取营收数据")
+@command_handler
+def revenue(
+    start_date: str | None = typer.Option(
+        None,
+        "--start-date",
+        help="开始日期，格式 YYYY-MM-DD。",
+    ),
+    end_date: str | None = typer.Option(
+        None,
+        "--end-date",
+        help="结束日期，格式 YYYY-MM-DD。",
+    ),
+    center_id: str = typer.Option(
+        ...,
+        "--center-id",
+        help="门店ID。",
+    ),
+) -> None:
+    validate_optional_date_range(start_date, end_date)
+
+    api = _build_api()
+    data = api.report.get_revenue(
+        start_date=start_date,
+        end_date=end_date,
+        center_id=center_id,
+    )
+    print_json({"status": "ok", "data": data})
+
+
+@app.command("revenue-detail", help="获取营收明细数据")
+@command_handler
+def revenue_detail(
+    detail_type: str = typer.Option(
+        ...,
+        "--type",
+        help="营收明细类型。",
+    ),
+    start_date: str | None = typer.Option(
+        None,
+        "--start-date",
+        help="开始日期，格式 YYYY-MM-DD。",
+    ),
+    end_date: str | None = typer.Option(
+        None,
+        "--end-date",
+        help="结束日期，格式 YYYY-MM-DD。",
+    ),
+    center_id: str = typer.Option(
+        ...,
+        "--center-id",
+        help="门店ID。",
+    ),
+) -> None:
+    validate_optional_date_range(start_date, end_date)
+
+    api = _build_api()
+    data = api.report.get_revenue_detail(
+        type_=detail_type,
+        start_date=start_date,
+        end_date=end_date,
+        center_id=center_id,
+    )
+    print_json({"status": "ok", "data": data})

bocai_cli/commands/reservation.py

@@ -0,0 +1,71 @@
+from __future__ import annotations
+
+import typer
+
+from bocai_cli.api import ApiFacade
+from bocai_cli.command_utils import command_handler
+from bocai_cli.config import load_config
+from bocai_cli.date_range_validation import validate_date_range
+from bocai_cli.output import print_json
+
+app = typer.Typer(help="预约相关命令。", invoke_without_command=True)
+
+
+@app.callback()
+def reservation_root(ctx: typer.Context) -> None:
+    if ctx.invoked_subcommand is None:
+        typer.echo(ctx.get_help())
+        raise typer.Exit(code=0)
+
+
+def _build_api() -> ApiFacade:
+    config = load_config()
+    return ApiFacade(
+        base_url=config.base_url,
+        token=config.token,
+        timeout_seconds=config.timeout_seconds,
+    )
+
+
+@app.command("list", help="获取预约记录数据")
+@command_handler
+def list_reservation(
+    start_date: str = typer.Option(
+        ...,
+        "--start-date",
+        help="开始日期，格式 YYYY-MM-DD。",
+    ),
+    end_date: str = typer.Option(
+        ...,
+        "--end-date",
+        help="结束日期，格式 YYYY-MM-DD。",
+    ),
+    page_num: int = typer.Option(
+        ...,
+        "--page-num",
+        min=0,
+        help="页码，必须大于等于 0。",
+    ),
+    page_size: int = typer.Option(
+        ...,
+        "--page-size",
+        min=1,
+        help="每页条数，必须大于等于 1。",
+    ),
+    center_id: str = typer.Option(
+        ...,
+        "--center-id",
+        help="门店ID。",
+    ),
+) -> None:
+    validate_date_range(start_date, end_date)
+
+    api = _build_api()
+    data = api.reservation.list(
+        start_date=start_date,
+        end_date=end_date,
+        page_num=page_num,
+        page_size=page_size,
+        center_id=center_id,
+    )
+    print_json({"status": "ok", "data": data})

bocai_cli/config.py

@@ -0,0 +1,121 @@
+from __future__ import annotations
+
+import os
+import sys
+from dataclasses import asdict, dataclass
+from pathlib import Path
+from typing import Any
+
+import tomli_w
+
+from bocai_cli.errors import ConfigValidationError
+
+try:
+    import tomllib
+except ModuleNotFoundError:  # pragma: no cover
+    import tomli as tomllib  # type: ignore[no-redef]
+
+DEFAULT_CONFIG_PATH = Path.home() / ".config" / "bocai-cli" / "config.toml"
+DEFAULT_BASE_URL = "https://openapi.forzadata.cn/"
+
+
+@dataclass
+class AppConfig:
+    base_url: str | None = DEFAULT_BASE_URL
+    token: str | None = None
+    timeout_seconds: float = 30.0
+    app_id: str | None = None
+    secret: str | None = None
+    token_url: str | None = None
+    token_backup: str | None = None
+    token_updated_at: str | None = None
+    refresh_token: str | None = None
+    expires_at: str | None = None
+
+
+def get_config_path() -> Path:
+    raw_path = os.getenv("BOCAI_CLI_CONFIG_PATH")
+    if raw_path:
+        return Path(raw_path).expanduser()
+    return DEFAULT_CONFIG_PATH
+
+
+def load_config(path: Path | None = None) -> AppConfig:
+    config_path = path or get_config_path()
+    if not config_path.exists():
+        return AppConfig()
+
+    try:
+        with config_path.open("rb") as f:
+            data = tomllib.load(f)
+    except tomllib.TOMLDecodeError as exc:
+        raise ConfigValidationError(
+            "配置文件格式错误，请检查 TOML 语法。",
+            details={"config_path": str(config_path)},
+        ) from exc
+    except OSError as exc:
+        raise ConfigValidationError(
+            "配置文件读取失败，请检查文件权限或路径。",
+            details={"config_path": str(config_path)},
+        ) from exc
+
+    return AppConfig(
+        base_url=_optional_string(data.get("base_url")) or DEFAULT_BASE_URL,
+        token=_optional_string(data.get("token")),
+        timeout_seconds=_optional_float(data.get("timeout_seconds"), default=30.0),
+        app_id=_optional_string(data.get("app_id")),
+        secret=_optional_string(data.get("secret")),
+        token_url=_optional_string(data.get("token_url")),
+        token_backup=_optional_string(data.get("token_backup")),
+        token_updated_at=_optional_string(data.get("token_updated_at")),
+        refresh_token=_optional_string(data.get("refresh_token")),
+        expires_at=_optional_string(data.get("expires_at")),
+    )
+
+
+def save_config(config: AppConfig, path: Path | None = None) -> Path:
+    config_path = path or get_config_path()
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+
+    payload = _to_toml_payload(config)
+    with config_path.open("wb") as f:
+        f.write(tomli_w.dumps(payload).encode("utf-8"))
+
+    _enforce_permissions_best_effort(config_path)
+    return config_path
+
+
+def _to_toml_payload(config: AppConfig) -> dict[str, Any]:
+    values = asdict(config)
+    payload: dict[str, Any] = {}
+    for key, value in values.items():
+        if value is None:
+            continue
+        payload[key] = value
+    return payload
+
+
+def _optional_string(raw: Any) -> str | None:
+    if raw is None:
+        return None
+    value = str(raw).strip()
+    return value or None
+
+
+def _optional_float(raw: Any, default: float) -> float:
+    if raw is None:
+        return default
+    try:
+        return float(raw)
+    except (TypeError, ValueError):
+        return default
+
+
+def _enforce_permissions_best_effort(path: Path) -> None:
+    if sys.platform.startswith("win"):
+        return
+
+    try:
+        path.chmod(0o600)
+    except OSError:
+        return

bocai_cli/date_range_validation.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+from datetime import date, datetime
+
+from bocai_cli.errors import ConfigValidationError
+
+
+def _parse_date(value: str, *, option_name: str) -> date:
+    try:
+        return datetime.strptime(value, "%Y-%m-%d").date()
+    except ValueError as exc:
+        raise ConfigValidationError(
+            f"--{option_name} 格式必须为 YYYY-MM-DD。",
+            details={"invalid": [option_name]},
+        ) from exc
+
+
+def validate_date_range(start_date: str, end_date: str) -> None:
+    start = _parse_date(start_date, option_name="start-date")
+    end = _parse_date(end_date, option_name="end-date")
+    if start > end:
+        raise ConfigValidationError(
+            "--start-date 不能晚于 --end-date。",
+            details={"start_date": start_date, "end_date": end_date},
+        )
+
+    range_days = (end - start).days + 1
+    if range_days > 31:
+        raise ConfigValidationError(
+            "--start-date 到 --end-date 的时间范围不能超过 31 天。",
+            details={
+                "start_date": start_date,
+                "end_date": end_date,
+                "range_days": range_days,
+            },
+        )
+
+
+def validate_optional_date_order(
+    start_date: str | None,
+    end_date: str | None,
+    *,
+    start_option_name: str = "start-date",
+    end_option_name: str = "end-date",
+) -> None:
+    start = _parse_date(start_date, option_name=start_option_name) if start_date else None
+    end = _parse_date(end_date, option_name=end_option_name) if end_date else None
+
+    if start is not None and end is not None and start > end:
+        raise ConfigValidationError(
+            f"--{start_option_name} 不能晚于 --{end_option_name}。",
+            details={"start_date": start_date, "end_date": end_date},
+        )
+
+
+def validate_optional_date_range(start_date: str | None, end_date: str | None) -> None:
+    if (start_date is None) != (end_date is None):
+        raise ConfigValidationError("--start-date 和 --end-date 必须同时提供。")
+
+    if start_date is None and end_date is None:
+        return
+
+    assert start_date is not None
+    assert end_date is not None
+    validate_date_range(start_date, end_date)

bocai_cli/errors.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any
+
+
+@dataclass
+class BocaiCliError(Exception):
+    message: str
+    status_code: int | None = None
+    details: dict[str, Any] = field(default_factory=dict)
+
+    def __str__(self) -> str:
+        return self.message
+
+
+class ConfigValidationError(BocaiCliError):
+    pass
+
+
+class ApiRequestError(BocaiCliError):
+    pass

bocai_cli/main.py

@@ -0,0 +1,8 @@
+from __future__ import annotations
+
+from bocai_cli.app import create_app
+
+app = create_app("gym")
+
+if __name__ == "__main__":
+    app()

bocai_cli/output.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+import json
+from typing import Any
+
+import typer
+
+
+def print_json(payload: dict[str, Any]) -> None:
+    typer.echo(json.dumps(payload, ensure_ascii=False))
+
+
+def print_error(
+    message: str,
+    *,
+    status_code: int | None = None,
+    details: dict[str, Any] | None = None,
+) -> None:
+    error_payload: dict[str, Any] = {
+        "status": "error",
+        "message": message,
+    }
+    if status_code is not None:
+        error_payload["status_code"] = status_code
+    if details:
+        error_payload["details"] = details
+
+    print_json(error_payload)

bocai_cli/product.py

@@ -0,0 +1,10 @@
+from __future__ import annotations
+
+from typing import Literal
+
+Product = Literal["gym", "studio"]
+
+PRODUCT_HELP: dict[Product, str] = {
+    "gym": "菠菜健身房CLI",
+    "studio": "菠菜工作室CLI",
+}

bocai_cli_core-0.2.0.dist-info/METADATA

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: bocai-cli-core
+Version: 0.2.0
+Summary: Shared core for Bocai CLI products
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: tenacity>=9.0.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: typer>=0.12.3
+Provides-Extra: dev
+Requires-Dist: pytest>=8.2.0; extra == 'dev'
+Requires-Dist: respx>=0.21.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# bocai-cli
+
+使用 Python + Typer 封装 SaaS API 的命令行工具。当前提供健身房和工作室两个产品入口，共享同一套核心代码和配置。
+
+| 产品 | 安装包 | 命令 |
+| --- | --- | --- |
+| 健身房 | `bocai-cli` | `bocai-cli` |
+| 工作室 | `bocai-studio-cli` | `bocai-studio-cli` |
+
+## 开发安装
+
+先安装共享核心，再安装两个产品入口：
+
+```bash
+python -m pip install -e .
+python -m pip install --no-deps -e packages/bocai-cli -e packages/bocai-studio-cli
+```
+
+也可以只安装某一个产品入口：
+
+```bash
+python -m pip install --no-deps -e packages/bocai-cli
+```
+
+## 构建离线 wheel
+
+构建机需要先安装 hatchling：
+
+```bash
+python -m pip install "hatchling>=1.24.2"
+```
+
+构建三个同版本 wheel，并同时收集运行依赖：
+
+```bash
+python scripts/build_wheels.py
+```
+
+如果依赖已经由内网镜像提供，只构建产品 wheel：
+
+```bash
+python scripts/build_wheels.py --no-deps
+```
+
+构建产物位于 `dist/`，包括 `bocai-cli-core`、`bocai-cli` 和 `bocai-studio-cli`。
+
+## 离线安装
+
+健身房机器：
+
+```bash
+python -m pip install --no-index --find-links dist bocai-cli==0.2.0
+```
+
+工作室机器：
+
+```bash
+python -m pip install --no-index --find-links dist bocai-studio-cli==0.2.0
+```
+
+如果机器上已有旧版 `bocai-cli`，仅安装工作室版前先执行：
+
+```bash
+python -m pip uninstall -y bocai-cli
+```
+
+如果机器上安装过旧包名 `bocai-cli-studio`，先卸载旧包再安装 `bocai-studio-cli`：
+
+```bash
+python -m pip uninstall -y bocai-cli-studio
+```
+
+## 安装后验证
+
+```bash
+bocai-cli --help
+bocai-studio-cli --help
+bocai-cli report --help
+bocai-studio-cli card --help
+```
+
+## 工作室命令迁移
+
+健身房版只包含健身房命令，不包含 `studio-*` 命令。工作室能力统一在 `bocai-studio-cli` 中提供，并去掉 `studio-` 前缀。旧版命令迁移如下：
+
+| 旧版 `bocai-cli` 命令 | 新工作室命令 |
+| --- | --- |
+| `center studio-seller-list` | `bocai-studio-cli center seller-list` |
+| `center studio-trainer-list` | `bocai-studio-cli center trainer-list` |
+| `member studio-proposed-list` | `bocai-studio-cli member proposed-list` |
+| `member studio-member-list` | `bocai-studio-cli member member-list` |
+| `card studio-contract-list` | `bocai-studio-cli card contract-list` |
+| `card studio-sale-performance` | `bocai-studio-cli card sale-performance` |
+| `card studio-private-consume-performance` | `bocai-studio-cli card private-consume-performance` |
+
+`center card-list`、`center source-list`、`center tag-list` 现在只保留在工作室版；健身房 `bocai-cli center` 只提供 `list` 和 `manager-phone`。
+
+`bocai-cli` 暂不提供 `member` 命令组，所有会员命令请使用 `bocai-studio-cli member ...`，包括 `detail`、`proposed-list` 和 `member-list`。
+
+`bocai-cli card contract-detail` 暂时移除，需要使用 `bocai-studio-cli card contract-detail`。
+
+工作室版不提供 `course` 命令组；课程相关命令仅保留在健身房版 `bocai-cli course ...`。
+
+`bocai-studio-cli card sale-performance` 指向工作室销售业绩；`bocai-cli card sale-performance` 仍指向健身房售卡业绩。两组命令不会互相出现在对方的帮助中。
+
+`guanyuan absence-statistics` 和 `guanyuan absence-detail` 按产品设置默认业态：健身房默认 `--type 2`，允许 `2/3`；工作室默认 `--type 1`，只允许 `1`。
+
+## 配置文件
+
+两个产品共用现有配置：
+
+- 优先读取环境变量 `BOCAI_CLI_CONFIG_PATH`。
+- 未设置时读取 `~/.config/bocai-cli/config.toml`。
+- Windows 默认路径为 `C:\Users\{用户名}\.config\bocai-cli\config.toml`。
+
+`config.toml` 示例（`base_url`、`app_id`、`secret` 按实际替换）：
+
+```toml
+base_url = "http://10.0.0.227:10086"
+app_id = "test_app_001"
+secret = "test_secret_123456"
+```

bocai_cli_core-0.2.0.dist-info/RECORD

@@ -0,0 +1,42 @@
+bocai_cli/__init__.py,sha256=QwLGZDZhVE7dBKbOwCLRt3tRMXTtg8fYYHHDXi3sZ1c,49
+bocai_cli/app.py,sha256=B-lN54_hDnM0ftMDKWQFACPJNTcFrO7evdonu1flXVI,357
+bocai_cli/client.py,sha256=xjtirUDW9ip3kHAhKaTnaXiqtZaFMqx81Yx5KFQogzs,1754
+bocai_cli/command_utils.py,sha256=JlE_fh_cWRpEnoUamNLrZSEm-GOWy-QdiXHDW3Xgt9c,764
+bocai_cli/config.py,sha256=dwu7X-5wSN-tJTyquBvYlxZu13UXtv08KVKBK1Od2BI,3657
+bocai_cli/date_range_validation.py,sha256=22UqaOtL8q4KrxsAz_TI4qsmq7Aqwtvh06N5_yzWnqw,2202
+bocai_cli/errors.py,sha256=1r9104aIibAmGIIGOBwwggZNPl-PpT-6mZo-wMi5qa0,418
+bocai_cli/main.py,sha256=6_BDJbCwg4L89EntF6DMZ7KmE13vDOMikTU97GsA0rI,137
+bocai_cli/output.py,sha256=c-kvmVpuTxY-CEVuRv93nyEGy5Tu-jPGsrfuHKd3F4o,598
+bocai_cli/product.py,sha256=V_vegkhYX2U5Nc-Z084WlzU3WEncbCSl7z8K8M3Zagw,208
+bocai_cli/api/__init__.py,sha256=3gmi1ICIKAmyBqLPfQS2XdIb-IgdN_fTuXy0aV1RAqk,978
+bocai_cli/api/auth_client.py,sha256=C38FDhrWh1WpK1cpfznFPY35n-OeufgwFzTGexD_s6E,1776
+bocai_cli/api/card_client.py,sha256=9De6Q8h79ixoMWNkyqI3NzStqLdOyLNZ01159zUTORs,6714
+bocai_cli/api/center_client.py,sha256=_3SLniorOkkQh7c730g8GNGCt5WazlNyWK0FgB-yElM,1653
+bocai_cli/api/checkin_client.py,sha256=H620MXbPtc_06ncVuQgj7ksh2ZkiTUEntxWZeb0J_ts,755
+bocai_cli/api/course_client.py,sha256=dDx-a-SBx2ilUcDudqqh4BTmCUa0oFkjlokj0_l3dCo,2300
+bocai_cli/api/facade.py,sha256=mA0PMmxWNjB_a1RH4H6KXjBwwY1EfDjVqL-8_KsMPQY,1593
+bocai_cli/api/guanyuan_client.py,sha256=BY-vuFM1lrAkQ7ogkv92u6h4RnJMb39zypt5M3Z7Tck,1419
+bocai_cli/api/member_client.py,sha256=sQl1NTOzD2h1Z2LwZPyBFq6ZdBrmvM5RlMJuZKL6mEQ,3139
+bocai_cli/api/month_dashboard_client.py,sha256=NjS1GY7Vc2jwOLUH0B3WB52f8pEeFwh3-rNEXZ0Q3A0,3143
+bocai_cli/api/qywx_client.py,sha256=t5QY8l2v5pvBZR4tsgjx0yihUvhV2i7AxQ10vRrQ2Is,873
+bocai_cli/api/report_client.py,sha256=pQQ71_gIowMH3AX9cVnOd3UZWpgf5gpoNKhkx-2qZCY,1343
+bocai_cli/api/reservation_client.py,sha256=4DmgazRQIPLtuvxNR_p-QUyzexk6NMemtuXz3uX4wDw,763
+bocai_cli/api/transport.py,sha256=WoafWXQcVZRb2TaoOGARkbjyUK2ymPyybCz40NTY_Yw,6142
+bocai_cli/commands/__init__.py,sha256=PP8ldg76MZGWkuSZ4ht-61OZX8Fz-E3JvsBKJDtMlm4,444
+bocai_cli/commands/auth.py,sha256=sJ5bJ-4DY2Rs3gAJO6Bcjm0N9naGVwKO_5wtpwJq_SM,5739
+bocai_cli/commands/card.py,sha256=pj_32H4Q2xBQ4X11fYaEs4lPNA-PEoYtEsV_v9WYtC4,19566
+bocai_cli/commands/center.py,sha256=nT42odMuVPRDDC3K0ONpDM4MsH7IM2A8KvitxHIvN-A,3684
+bocai_cli/commands/checkin.py,sha256=xpD80uyHu4SgVCe5pSmsnaeQkl2uaHFs88Ydi38jKho,1781
+bocai_cli/commands/course.py,sha256=VitQQeuBT-VNJVRS0_9wT-Eu5iYupFg4m6FKnl3x3dk,7876
+bocai_cli/commands/customreport.py,sha256=Gq50LtWvVB-yjNXXBbxjs0FhA3Q9aSg2rvgTTon77Ck,1919
+bocai_cli/commands/guanyuan.py,sha256=xJEW1h_gg44F8KFOoo7GCoQEu1SjCiXinr_QxTlnvxU,2567
+bocai_cli/commands/member.py,sha256=5WvhqrLHHhTN1iAKUFYgJOke_SDWMxdOpL8IvkrcCdI,8231
+bocai_cli/commands/month_dashboard.py,sha256=sm4CDZMwv1tN3s3V0W09DVPYaHfYko-CoH4HhI3t0vY,5547
+bocai_cli/commands/qywx.py,sha256=vooHJM9R80Kh8kiBllJKadtjYJiubPWAlTxiXdi9D68,3435
+bocai_cli/commands/registry.py,sha256=Kk9PjPOLdayuqJMET-cVGA2odMslJQUPf68BKjMTmbM,2950
+bocai_cli/commands/report.py,sha256=u7yKBkFJnCys_btkOM5ZrhHxyxq-MYroSgJx2HEUy2k,2365
+bocai_cli/commands/reservation.py,sha256=H7RQoKT2hxI5QRiz9K23MkqM3P-_2ambc5LMOr8Zlys,1793
+bocai_cli_core-0.2.0.dist-info/METADATA,sha256=Mc1QYwCxnX6KYd8f2oD96dntoD4wMucWgKIZ6PU5R6o,4317
+bocai_cli_core-0.2.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+bocai_cli_core-0.2.0.dist-info/licenses/LICENSE,sha256=6kbiFSfobTZ7beWiKnHpN902HgBx-Jzgcme0SvKqhKY,1091
+bocai_cli_core-0.2.0.dist-info/RECORD,,

bocai_cli_core-0.2.0.dist-info/WHEEL

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

bocai_cli_core-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 The Python Packaging Authority
+
+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.