cypherast 0.1.0__tar.gz

cypherast-0.1.0/.agents/rules/architecture.md

@@ -0,0 +1,29 @@
+---
+description: Pipeline layers and module boundaries for cypherast
+alwaysApply: true
+---
+
+# Architecture
+
+Pipeline order (do not skip layers or import backwards):
+
+1. **Lexer / parser** (`lexer.py`, `parser.py`) → AST (`ast.py`)
+2. **Dialect** (`dialects/`) — parse/render hooks, `capabilities`, constraint rewrites
+3. **Rewriter passes** (`rewriter/`) — pure AST transforms
+4. **Optimizer** (`optimizer/`) — named `Rule` / `RuleSet`, catalogs, `only`/`disable`
+5. **Planner** (`planner/`) — explain / cost / physical ops
+6. **Executor** (`executor/`) — in-memory `Graph` + engine
+
+## Rules
+
+- Public surface stays in `cypherast/__init__.py` (+ CLI). New user-facing entry points go there.
+- Dialect-specific engine limits belong in `DialectCapabilities` + `constraints.py` / `constraint_rules`, not hard-coded label/rel names from one customer graph.
+- Rewrite implementations live in `rewriter/`; registration/order/names live in `optimizer/catalog.py`.
+- Rendering goes through `Renderer` / `AstNode.cypher(...)` — keep dialect emit differences in dialect renderer subclasses when needed.
+- Avoid circular imports: `rewriter/__init__.py` must not import `optimizer` at module top level (optimizer catalog imports rewriter pass modules).
+
+## Anti-patterns
+
+- SQL vocabulary or SQL-toolchain brand names in APIs/docs
+- Putting PuppyGraph (or any engine) hacks into shared openCypher paths without a capability flag
+- Enabling `merge_match_chains` by default

cypherast-0.1.0/.agents/rules/graph-native-naming.md

@@ -0,0 +1,32 @@
+---
+description: Keep cypherast graph-native — no SQL-clone framing or foreign brand names
+alwaysApply: true
+---
+
+# Graph-native naming
+
+cypherast is a **Cypher/GQL** library. Do not frame it as a SQL toolchain clone in code, comments, docs, tests, READMEs, commit messages, or user-facing copy. Do not cite third-party SQL library brand names.
+
+## Do
+
+- Describe features in graph/Cypher terms: named rewrite rules, dialects, `only`/`disable`, capability constraints.
+- Use graph-native vocabulary (MATCH, pattern, binding, hop).
+
+## Don't
+
+```text
+# BAD
+"SQL-style optimizer like <sql library>"
+"transpile_sql" / AstNode.sql()
+customer- or employer-specific product codenames in public docs
+```
+
+```text
+# GOOD
+"named rule filters"
+"enable/disable by rule name"
+AstNode.cypher()
+generic engine capability limits
+```
+
+Keep the idea; drop foreign brand names and internal org jargon from the public repo.

cypherast-0.1.0/.agents/rules/testing.md

@@ -0,0 +1,22 @@
+---
+description: Pytest conventions for cypherast
+globs: tests/**/*.py
+alwaysApply: false
+---
+
+# Testing
+
+- Framework: **pytest** (`tests/`, `testpaths` in `pyproject.toml`).
+- Name files `tests/test_*.py`. Prefer focused cases over giant fixtures.
+- Public API tests go through `import cypherast` (`parse_one`, `optimize`, `translate`, `validate`).
+- Dialect capability tests: `tests/test_puppygraph_dialect.py`.
+- Named rule filters: `tests/test_optimizer_rules.py`.
+- Parser/hardening: `tests/test_parse.py`, `tests/test_hardening.py`.
+- TCK parse-rate: `tests/tck/` via `make test-tck` — do not treat sample `.feature` files as a full openCypher TCK.
+
+## Rules
+
+- Assert on rendered Cypher (`.cypher(...)`) or structured AST — not private rewriter helpers unless unit-testing that helper.
+- When testing `only`/`disable`/`constraint_disable`, name the rule exactly as in `RULES.names` / `constraint_rule_set().names`.
+- After dialect constraint changes, keep `make test-puppy` green.
+- No network / live graph engines in unit tests — use in-memory `Graph` or AST-only checks.

cypherast-0.1.0/.github/copilot-instructions.md

@@ -0,0 +1,74 @@
+# GitHub Copilot — repository-wide instructions (chat, coding agent, code review)
+
+## What this repo is
+
+**cypherast** is a Cypher/GQL library (lexer → parser → AST → named rewrite rules → planner → in-memory executor).
+Python 3.13+, zero runtime dependencies, MIT. Public API lives in `cypherast/__init__.py`.
+
+This is a **graph query** toolchain. Use Cypher/GQL vocabulary (MATCH, pattern, binding, hop, dialect). Do not frame APIs or reviews in SQL terms.
+
+For deeper agent context see root `AGENTS.md`. Prefer that file over inventing architecture.
+
+## When reviewing a PR
+
+Flag as blockers:
+
+1. New runtime dependencies without clear justification
+2. SQL-shaped public names (`sql()`, `transpile_sql`, etc.) or docs that describe the library as a SQL clone
+3. Enabling `merge_match_chains` in default `RULES` (Cartesian risk on some engines)
+4. Hard-coding customer-specific graph labels/rel types into dialect constraint code — use `DialectCapabilities` / generic rules
+5. Qualifying anonymous variables inside pattern predicates (engines reject new bindings there)
+6. Breaking `AstNode.cypher(...)` / `cypher=` public naming
+7. Skipping tests for parser, rewriter, optimizer rule, or dialect capability changes
+8. Lowering coverage gate or silencing CI (`|| true` on mypy/tests) without discussion
+
+Nits (non-blocking unless pervasive):
+
+- Missing type hints on new public functions
+- Rewriter pass registered in the wrong order vs `optimizer/catalog.py`
+- Docs/README not updated when public API changed
+
+## Architecture map (for understanding diffs)
+
+| Path | Owns |
+|------|------|
+| `cypherast/lexer.py`, `parser.py`, `ast.py` | Tokenize / parse / IR |
+| `cypherast/dialects/` | Dialect registry, capabilities, constraint rewrites |
+| `cypherast/rewriter/` | Individual AST rewrite passes |
+| `cypherast/optimizer/` | Named `Rule` / `RuleSet`, catalogs, `only`/`disable` |
+| `cypherast/planner/` | Explain / cost / plans |
+| `cypherast/executor/` | In-memory `Graph` + execute |
+| `cypherast/renderer.py` | AST → Cypher text |
+| `tests/` | pytest; `tests/tck/` = sample parse-rate features only |
+
+Pipeline order: parse → (optional) optimize/constraints → render / plan / run.
+
+## Dialects & optimize
+
+- Dialects: `opencypher`, `neo4j`, `memgraph`, `puppygraph`
+- `optimize(..., write=)` applies canonicalizer rules then write-dialect constraints
+- Filters: `only` / `disable` (canonicalizer), `constraint_only` / `constraint_disable`
+- Default rules: `qualify` → `canonicalize_patterns` → `simplify` → `pushdown_predicates` → `annotate_types`
+- Opt-in: `OPTIONAL_RULES` includes `merge_match_chains`
+
+## How to verify locally (tell authors)
+
+```bash
+uv sync --group dev
+make check          # ruff + mypy + pytest
+make test-cov       # coverage XML + term
+make test-puppy     # PuppyGraph dialect tests
+```
+
+CI workflows:
+
+- `.github/workflows/ci.yml` — ruff, mypy (strict), pytest with `--cov-fail-under=60`, uploads `coverage.xml`
+- `.github/workflows/release.yml` — tag `v*` → verify version → build → PyPI (OIDC) → GitHub Release
+
+## Coding conventions for suggestions
+
+- Match existing style: ruff line-length 100, mypy strict, Python 3.13
+- Prefer small, test-backed changes over large refactors
+- New rewrite logic → implement under `rewriter/`, register name in `optimizer/catalog.py`
+- New engine limits → `DialectCapabilities` + named constraint rule, not one-off string hacks
+- Keep comments/docs free of SQL-toolchain brand names

cypherast-0.1.0/.github/instructions/python.instructions.md

@@ -0,0 +1,12 @@
+---
+applyTo: "**/*.py"
+---
+
+# Python review focus (cypherast)
+
+- Prefer graph/Cypher naming in identifiers and user-facing strings.
+- Public API changes must update `cypherast/__init__.py` exports and usually `docs/api.md` / `README.md`.
+- Avoid circular imports: do not import `cypherast.optimizer` at the top of `cypherast/rewriter/__init__.py`.
+- Dialect constraint callables should accept `(tree, schema=None)` so `RuleSet.apply` can pass kwargs.
+- Tests: use `cypherast.parse_one` / `optimize` / `translate` / `validate`; assert via `.cypher(...)` when checking emit.
+- Typecheck is strict (`mypy` on `cypherast` package) — new public functions need annotations.

cypherast-0.1.0/.github/instructions/review.instructions.md

@@ -0,0 +1,24 @@
+---
+applyTo: ".github/workflows/**/*.yml,cypherast/dialects/**/*.py,cypherast/optimizer/**/*.py,cypherast/rewriter/**/*.py"
+---
+
+# High-risk paths — Copilot code review
+
+When reviewing changes under dialects, optimizer, rewriter, or CI workflows:
+
+## Dialects / constraints
+
+- Confirm capability flags match rewrite behavior (`require_limit_on_row_return`, `allow_cartesian_match_paths`, var-length bounds).
+- Do not reintroduce default MATCH-chain merge or `exists()` emit for PuppyGraph unless capabilities explicitly allow it.
+- Unbounded `*` var-length must remain allowed when `allow_unbounded_var_length=True` and `max_var_length_hops is None`.
+
+## Optimizer / rewriter
+
+- Rule names in `only`/`disable` must match catalog names exactly.
+- Keep `merge_match_chains` in `OPTIONAL_RULES` only unless the PR deliberately changes that policy and updates docs/tests.
+
+## CI
+
+- Do not drop coverage fail-under without calling it out in the PR.
+- Do not make mypy or pytest non-blocking again.
+- Coverage runs in the CI `test` job and must still produce `coverage.xml` artifact on failure when possible.

cypherast-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,87 @@
+# CI — lint, types, tests + coverage
+
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - name: Sync deps
+        run: uv sync --group dev
+      - name: Ruff
+        run: uv run ruff check cypherast tests
+
+  typecheck:
+    name: Typecheck (mypy)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - name: Sync deps
+        run: uv sync --group dev
+      - name: Mypy (strict)
+        run: uv run mypy cypherast
+
+  test:
+    name: Tests + coverage
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+      - name: Sync deps
+        run: uv sync --group dev
+      - name: Pytest + coverage
+        run: >
+          uv run pytest
+          --cov=cypherast
+          --cov-report=term-missing:skip-covered
+          --cov-report=xml:coverage.xml
+          --cov-fail-under=60
+      - name: PuppyGraph dialect suite
+        run: uv run pytest tests/test_puppygraph_dialect.py -q
+      - name: Upload coverage.xml
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-xml
+          path: coverage.xml
+          if-no-files-found: warn
+          retention-days: 14
+      - name: Coverage summary (PR)
+        if: github.event_name == 'pull_request'
+        run: |
+          python - <<'PY'
+          import xml.etree.ElementTree as ET
+          from pathlib import Path
+          p = Path("coverage.xml")
+          if not p.exists():
+              print("coverage.xml missing")
+              raise SystemExit(0)
+          root = ET.parse(p).getroot()
+          line_rate = float(root.attrib.get("line-rate", "0"))
+          pct = round(line_rate * 100, 1)
+          print(f"Line coverage: {pct}% (fail-under 60%)")
+          PY

cypherast-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,64 @@
+# Release — build + publish to PyPI on version tags (v*)
+
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write   # GitHub Release
+  id-token: write   # PyPI trusted publishing (OIDC)
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release:
+    name: Build, verify, publish
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: "3.13"
+
+      - name: Sync deps
+        run: uv sync --group dev
+
+      - name: Tag must match pyproject version
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          PKG=$(uv run python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          echo "tag=$TAG  pyproject=$PKG"
+          test "$TAG" = "$PKG" || {
+            echo "::error::Tag v$TAG does not match project.version=$PKG in pyproject.toml"
+            exit 1
+          }
+
+      - name: Quality gate
+        run: |
+          uv run ruff check cypherast tests
+          uv run mypy cypherast
+          uv run pytest --cov=cypherast --cov-fail-under=60 -q
+
+      - name: Build sdist + wheel
+        run: uv build
+
+      - name: Check dist
+        run: uvx twine check dist/*
+
+      - name: Publish to PyPI
+        run: uv publish
+
+      - name: GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+          fail_on_unmatched_files: true

cypherast-0.1.0/.gitignore

@@ -0,0 +1,45 @@
+# Python / tooling
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+coverage.xml
+*.cover
+.hypothesis/
+.tox/
+.nox/
+
+# Secrets / credentials — never commit
+.env
+.env.*
+!.env.example
+*.pem
+*.key
+*.p12
+*.pfx
+id_rsa
+id_rsa.*
+id_ed25519
+id_ed25519.*
+*_secret*
+*credentials*
+*.token
+.secrets/
+secrets/
+
+# Editor / OS / local tool state (not shared)
+.DS_Store
+.idea/
+.vscode/
+*.swp
+*~
+.claude/
+.cursor/

cypherast-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

cypherast-0.1.0/AGENTS.md

@@ -0,0 +1,102 @@
+# cypherast — agent instructions
+
+Cypher/GQL library: lexer → parser → AST → named rewrite rules → planner → in-memory executor.
+Zero runtime deps. Python **3.13+**. Package version **0.1.0** (`pyproject.toml`). MIT.
+
+Canonical AI instructions live here. Topic rules live under `.agents/rules/` only (no tool-specific stub/rule trees in-repo).
+
+## Non-negotiables
+
+- Graph-native naming only (MATCH, pattern, binding, hop). No SQL vocabulary in public APIs or docs.
+- Never frame the library as a SQL toolchain clone — see `.agents/rules/graph-native-naming.md`.
+- Prefer `AstNode.cypher(...)` for render; public params use `cypher=`, not SQL-shaped names.
+- Do not add runtime dependencies without an explicit request.
+- Do not invent dialect capability limits — read `DialectCapabilities` / `cypherast/dialects/constraints.py`.
+- Do not hard-code customer-specific graph labels/rel types into dialect code.
+## Public API (`cypherast/__init__.py`)
+
+| Function | Role |
+|----------|------|
+| `parse` / `parse_one` | Cypher → AST (`read=` dialect) |
+| `optimize` | Canonicalizer + optional write-dialect constraints (`only` / `disable` / `constraint_*`) |
+| `translate` / `transpile` | Parse `from_` → render `to_`; `optimize=` applies target constraints |
+| `validate` | List capability `ConstraintIssue`s for a dialect |
+| `explain` / `profile` / `run` | Plan / profile / execute on in-memory `Graph` |
+| `lineage` | Binding provenance |
+
+CLI entry: `cypherast.cli:main` (`uv run cypherast …`).
+
+## Dialects
+
+Registered under `cypherast/dialects/`: `opencypher`, `neo4j`, `memgraph`, `puppygraph`.
+`Dialect.optimize` runs `cypherast.optimizer` `RULES` then `constraint_rules(capabilities)`.
+PuppyGraph caps are generic engine limits (LIMIT, no Cartesian multi-path MATCH, etc.) — keep dialect code free of domain-specific label/rel names.
+
+## Optimizer rules
+
+- Default `RULES`: `qualify` → `canonicalize_patterns` → `simplify` → `pushdown_predicates` → `annotate_types`
+- Opt-in: `OPTIONAL_RULES` (`merge_match_chains`) — not default (Cartesian risk on some engines)
+- Constraints built by `constraint_rules(caps)` — e.g. `ensure_row_limit`, `split_multi_path_match`
+
+## Dev commands (verified in `Makefile` / `pyproject.toml`)
+
+```bash
+uv sync --group dev
+make check          # ruff + mypy + pytest
+make test
+make test-puppy
+make optimize Q="MATCH (n:Person) RETURN n.name" WRITE=puppygraph
+make optimize Q="..." DISABLE=qualify CONSTRAINT_DISABLE=ensure_row_limit
+```
+
+CI:
+
+- `.github/workflows/ci.yml` — ruff, mypy (strict), pytest + coverage (fail-under 60%, uploads `coverage.xml`)
+- `.github/workflows/release.yml` — on `v*` tags: verify tag==version → check → `uv build` → `uv publish` (OIDC) → GitHub Release
+
+Copilot: `.github/copilot-instructions.md` (+ `.github/instructions/*.instructions.md`).
+
+## Project Structure
+
+Single Python package (uv + hatchling):
+
+```text
+cypherast/
+├── AGENTS.md                 # this file (canonical AI instructions)
+├── HOWTOAI.md
+├── CONTRIBUTING.md
+├── README.md
+├── Makefile
+├── pyproject.toml
+├── LICENSE
+├── .agents/rules/            # agent topic rules (canonical)
+│   ├── graph-native-naming.md
+│   ├── architecture.md
+│   └── testing.md
+├── .github/
+│   ├── copilot-instructions.md
+│   ├── instructions/         # path-scoped Copilot review rules
+│   └── workflows/
+│       ├── ci.yml            # lint + mypy + pytest/coverage
+│       └── release.yml       # tag v* → PyPI + GitHub Release
+├── docs/api.md
+├── cypherast/
+│   ├── __init__.py           # public API
+│   ├── ast.py
+│   ├── lexer.py
+│   ├── parser.py
+│   ├── renderer.py
+│   ├── cli.py
+│   ├── errors.py
+│   ├── schema.py
+│   ├── scope.py
+│   ├── lineage.py
+│   ├── dialects/             # Dialect + capabilities + constraints
+│   ├── rewriter/             # rewrite pass implementations
+│   ├── optimizer/            # Rule / RuleSet / RULES catalog
+│   ├── planner/
+│   └── executor/             # in-memory Graph + engine
+└── tests/
+    ├── test_*.py
+    └── tck/                  # sample .feature parse-rate suite
+```

cypherast-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,46 @@
+# Contributing to cypherast
+
+## Setup
+
+```bash
+uv sync --group dev
+make check
+```
+
+Requires Python 3.13+ (`requires-python` in `pyproject.toml`).
+
+## Workflow
+
+1. Keep changes scoped — match existing module boundaries (`dialects`, `rewriter`, `optimizer`, `planner`, `executor`).
+2. Add or update tests under `tests/` for behavior changes.
+3. Run `make check` (ruff, mypy, pytest) before opening a PR.
+4. Prefer graph-native naming; see `AGENTS.md` and `.agents/rules/`.
+
+## Code style
+
+- Ruff: line length 100, target `py313` (`pyproject.toml`).
+- Mypy: `strict = true` on the `cypherast` package.
+- Zero runtime dependencies unless explicitly agreed.
+
+## Tests
+
+```bash
+make test
+make test-cov
+make test-puppy
+make test-tck
+```
+
+CI runs ruff, mypy (strict), and pytest with coverage (fail-under 60%) in one workflow.
+
+## Release / PyPI
+
+1. Bump `version` in `pyproject.toml`.
+2. Tag `vX.Y.Z` matching that version and push the tag.
+3. `.github/workflows/release.yml` builds, publishes via PyPI trusted publishing, opens a GitHub Release.
+
+See README **Publishing to PyPI** for one-time publisher setup.
+
+## Docs
+
+Update `README.md` / `docs/api.md` when the public API changes. Keep AI instructions in `AGENTS.md` (not duplicated into tool stubs).

cypherast-0.1.0/HOWTOAI.md

@@ -0,0 +1,60 @@
+# How to Use AI with cypherast
+
+Practical guide for contributing with AI coding assistants.
+
+## Core principles
+
+- Human owns the PR. Understand every line before merge.
+- Match existing graph-native style: Cypher terms, zero runtime deps, typed Python 3.13.
+- Read `AGENTS.md` and `.agents/rules/` before large changes.
+- Never invent dialect limits — open `cypherast/dialects/capabilities.py` and `constraints.py`.
+
+## Best workflow
+
+1. Sync env: `uv sync --group dev`
+2. Reproduce with a minimal Cypher string via `parse_one` / `optimize` / `translate`
+3. Prefer TDD for parser/rewriter/dialect behavior (`tests/test_*.py`)
+4. Run `make check` (ruff + mypy + pytest) before claiming done
+5. For PuppyGraph emit path: also `make test-puppy` and `make validate Q="..."`
+
+### Useful Make targets
+
+```bash
+make help
+make optimize Q="MATCH (n:Person) WHERE n.status = 'ACTIVE' RETURN n.name"
+make optimize Q="..." WRITE=puppygraph CONSTRAINT_DISABLE=ensure_row_limit
+make translate Q="..." FROM=opencypher TO=puppygraph OPT=1
+make validate Q="MATCH (n) RETURN n" DIALECT=puppygraph
+```
+
+### Named optimizer rules
+
+```python
+import cypherast
+from cypherast.optimizer import RULES, OPTIONAL_RULES
+
+cypherast.optimize(q, disable=["qualify"])
+cypherast.optimize(q, write="puppygraph", constraint_disable=["ensure_row_limit"])
+cypherast.optimize(q, rules=RULES + OPTIONAL_RULES)  # opt-in merge_match_chains
+```
+
+## What to watch
+
+- Do not merge MATCH chains into comma paths by default — PuppyGraph rejects Cartesian multi-path MATCH.
+- Pattern predicates must not introduce new bindings; do not qualify anon vars inside them.
+- `AstNode.cypher(dialect=...)` for render checks after optimize/translate.
+- Keep `merge_match_chains` out of default `RULES` unless explicitly opting in.
+
+## Review bar for AI-authored PRs
+
+- Tests cover the behavior change (parser, rewriter, dialect, or API).
+- Docs/README/api only updated when the public surface changed.
+- No SQL-clone framing in comments or docs (see `.agents/rules/graph-native-naming.md`).
+- `make check` green locally.
+
+## Tools
+
+- Canonical instructions: `AGENTS.md`
+- Shared rules: `.agents/rules/` only
+- Copilot (optional): `.github/copilot-instructions.md`
+- Full API samples: `docs/api.md`

cypherast-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gaurav Sagar
+
+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.