lib-layered-config 1.0.0__py3-none-any.whl

lib_layered_config-1.0.0.dist-info/METADATA

@@ -0,0 +1,366 @@
+Metadata-Version: 2.4
+Name: lib_layered_config
+Version: 1.0.0
+Summary: Cross-platform layered configuration loader for Python
+Project-URL: Homepage, https://github.com/bitranox/lib_layered_config
+Project-URL: Repository, https://github.com/bitranox/lib_layered_config.git
+Project-URL: Issues, https://github.com/bitranox/lib_layered_config/issues
+Author-email: bitranox <bitranox@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: configuration,dotenv,env,layered,toml
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: lib-cli-exit-tools>=1.5.0
+Requires-Dist: rich-click>=1.9.2
+Provides-Extra: dev
+Requires-Dist: bandit>=1.7.9; extra == 'dev'
+Requires-Dist: build>=1.3; extra == 'dev'
+Requires-Dist: codecov-cli>=0.6; extra == 'dev'
+Requires-Dist: coverage[toml]>=7.10.7; extra == 'dev'
+Requires-Dist: hypothesis>=6.140.3; extra == 'dev'
+Requires-Dist: import-linter>=2.0; extra == 'dev'
+Requires-Dist: pip-audit>=2.7; extra == 'dev'
+Requires-Dist: pyright>=1.1; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=7.0; extra == 'dev'
+Requires-Dist: pytest>=8.4; extra == 'dev'
+Requires-Dist: pyyaml>=6.0; extra == 'dev'
+Requires-Dist: ruff>=0.13.3; extra == 'dev'
+Requires-Dist: textual>=6.1.0; extra == 'dev'
+Requires-Dist: twine>=6.2; extra == 'dev'
+Provides-Extra: yaml
+Requires-Dist: pyyaml>=6.0; extra == 'yaml'
+Description-Content-Type: text/markdown
+
+# lib_layered_config
+
+<!-- Badges -->
+[![CI](https://github.com/bitranox/lib_layered_config/actions/workflows/ci.yml/badge.svg)](https://github.com/bitranox/lib_layered_config/actions/workflows/ci.yml)
+[![CodeQL](https://github.com/bitranox/lib_layered_config/actions/workflows/codeql.yml/badge.svg)](https://github.com/bitranox/lib_layered_config/actions/workflows/codeql.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Open in Codespaces](https://img.shields.io/badge/Codespaces-Open-blue?logo=github&logoColor=white&style=flat-square)](https://codespaces.new/bitranox/lib_layered_config?quickstart=1)
+[![PyPI](https://img.shields.io/pypi/v/lib-layered-config.svg)](https://pypi.org/project/lib-layered-config/)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/lib-layered-config.svg)](https://pypi.org/project/lib-layered-config/)
+[![Code Style: Ruff](https://img.shields.io/badge/Code%20Style-Ruff-46A3FF?logo=ruff&labelColor=000)](https://docs.astral.sh/ruff/)
+[![codecov](https://codecov.io/gh/bitranox/lib_layered_config/graph/badge.svg)](https://codecov.io/gh/bitranox/lib_layered_config)
+[![Maintainability](https://qlty.sh/gh/bitranox/projects/lib_layered_config/maintainability.svg)](https://qlty.sh/gh/bitranox/projects/lib_layered_config)
+[![Known Vulnerabilities](https://snyk.io/test/github/bitranox/lib_layered_config/badge.svg)](https://snyk.io/test/github/bitranox/lib_layered_config)
+
+A cross-platform configuration loader that deep-merges application defaults, host overrides, user profiles, `.env` files, and environment variables into a single immutable object. The core follows Clean Architecture boundaries so adapters (filesystem, dotenv, environment) stay isolated from the domain model while the CLI mirrors the same orchestration.
+
+## Table of Contents
+
+1. [Key Features](#key-features)
+2. [Architecture Overview](#architecture-overview)
+3. [Installation](#installation)
+4. [Quick Start](#quick-start)
+5. [Configuration Sources & Precedence](#configuration-sources--precedence)
+6. [CLI Usage](#cli-usage)
+7. [Python API](#python-api)
+8. [Example Generation & Deployment](#example-generation--deployment)
+9. [Provenance & Observability](#provenance--observability)
+10. [Development](#development)
+11. [License](#license)
+
+## Key Features
+
+- **Deterministic layering** — precedence is always `defaults → app → host → user → dotenv → env`.
+- **Immutable value object** — returned `Config` prevents accidental mutation and exposes dotted-path helpers.
+- **Provenance tracking** — every key reports the layer and path that produced it.
+- **Cross-platform path discovery** — Linux (XDG), macOS, and Windows layouts with environment overrides for tests.
+- **Extensible formats** — TOML and JSON are built-in; YAML is available via the optional `yaml` extra.
+- **Automation-friendly CLI** — inspect, deploy, or scaffold configurations without writing Python.
+- **Structured logging** — adapters emit trace-aware events without polluting the domain layer.
+
+## Architecture Overview
+
+The project follows a Clean Architecture layout so responsibilities remain easy to reason about and test:
+
+- **Domain** — immutable `Config` value object plus error taxonomy.
+- **Application** — merge policy (`LayerSnapshot`, `merge_layers`) and adapter protocols.
+- **Adapters** — filesystem discovery, structured file loaders, dotenv, and environment ingress.
+- **Composition** — `core` and `_layers` wire adapters together and expose the public API.
+- **Presentation & Tooling** — CLI commands, deployment/example helpers, observability utilities, and testing hooks.
+
+Consult [`docs/systemdesign/module_reference.md`](docs/systemdesign/module_reference.md) for a per-module catalogue and traceability back to the system design notes.
+
+## Installation
+
+```bash
+pip install lib_layered_config
+# or with optional YAML support
+pip install "lib_layered_config[yaml]"
+```
+
+> **Requires Python 3.13+** — the standard-library `tomllib` handles TOML parsing.
+>
+> Install the optional `yaml` extra only when you actually ship `.yml` files to keep the dependency footprint small.
+
+For local development add tooling extras:
+
+```bash
+pip install "lib_layered_config[dev]"
+```
+
+## Quick Start
+
+```python
+from lib_layered_config import read_config
+
+config = read_config(vendor="Acme", app="ConfigKit", slug="config-kit")
+print(config.get("service.timeout", default=30))
+print(config.origin("service.timeout"))
+```
+
+CLI equivalent (human readable by default):
+
+```bash
+lib_layered_config read --vendor Acme --app ConfigKit --slug config-kit
+```
+
+JSON output including provenance:
+
+```bash
+lib_layered_config read --vendor Acme --app ConfigKit --slug config-kit --format json
+# or
+lib_layered_config read-json --vendor Acme --app ConfigKit --slug config-kit
+```
+
+## Configuration Sources & Precedence
+
+Later layers override earlier ones **per key** while leaving unrelated keys untouched.
+
+| Precedence | Layer       | Description |
+| ---------- | ----------- | ----------- |
+| 0          | `defaults`  | Optional baseline file provided via the API/CLI `--default-file` flag |
+| 1          | `app`       | System-wide defaults (e.g. `/etc/<slug>/…`) |
+| 2          | `host`      | Machine-specific overrides (`hosts/<hostname>.toml`) |
+| 3          | `user`      | Per-user settings (XDG, Application Support, AppData) |
+| 4          | `dotenv`    | First `.env` found via upward search plus platform extras |
+| 5          | `env`       | Process environment with namespacing and `__` nesting |
+
+Use the optional defaults layer when you want one explicitly-provided file to seed configuration before host/user overrides apply.
+
+Important directories (overridable via environment variables):
+
+### Linux
+- `/etc/<slug>/config.toml`
+- `/etc/<slug>/config.d/*.{toml,json,yaml,yml}`
+- `/etc/<slug>/hosts/<hostname>.toml`
+- `$XDG_CONFIG_HOME/<slug>/config.toml` (the resolver reads `$XDG_CONFIG_HOME`; if it is missing it falls back to `~/.config/<slug>/config.toml`)
+- `.env` search: current directory upwards + `$XDG_CONFIG_HOME/<slug>/.env`
+
+### macOS
+- `/Library/Application Support/<Vendor>/<App>/config.toml`
+- `/Library/Application Support/<Vendor>/<App>/config.d/`
+- `/Library/Application Support/<Vendor>/<App>/hosts/<hostname>.toml`
+- `~/Library/Application Support/<Vendor>/<App>/config.toml`
+- `.env` search: current directory upwards + `~/Library/Application Support/<Vendor>/<App>/.env`
+
+### Windows
+- `%ProgramData%\<Vendor>\<App>\config.toml`
+- `%ProgramData%\<Vendor>\<App>\config.d\*`
+- `%ProgramData%\<Vendor>\<App>\hosts\%COMPUTERNAME%.toml`
+- `%APPDATA%\<Vendor>\<App>\config.toml` (resolver order: `LIB_LAYERED_CONFIG_APPDATA` → `%APPDATA%`; if neither yields an existing directory it tries `LIB_LAYERED_CONFIG_LOCALAPPDATA` → `%LOCALAPPDATA%`)
+- `.env` search: current directory upwards + `%APPDATA%\<Vendor>\<App>\.env`
+
+Environment overrides: `LIB_LAYERED_CONFIG_ETC`, `LIB_LAYERED_CONFIG_PROGRAMDATA`, `LIB_LAYERED_CONFIG_APPDATA`, `LIB_LAYERED_CONFIG_LOCALAPPDATA`, `LIB_LAYERED_CONFIG_MAC_APP_ROOT`, `LIB_LAYERED_CONFIG_MAC_HOME_ROOT`. Both the runtime readers and the `deploy` helper honour these variables so generated files land in the same directories that `read_config` inspects.
+
+**Fallback note:** Whenever a path is marked as a fallback, the resolver first consults the documented environment overrides (`LIB_LAYERED_CONFIG_*`, `$XDG_CONFIG_HOME`, `%APPDATA%`, etc.). If those variables are unset or the computed directory does not exist, it switches to the stated fallback location (`~/.config`, `%LOCALAPPDATA%`, ...). This keeps local installs working without additional environment configuration while still allowing operators to steer resolution explicitly.
+
+## CLI Usage
+
+### Command Summary
+
+| Command                                | Description                                           |
+|----------------------------------------|-------------------------------------------------------|
+| `lib_layered_config read`              | Load configuration (human readable by default)        |
+| `lib_layered_config read-json`         | Emit config + provenance JSON envelope                |
+| `lib_layered_config deploy`            | Copy a source file into one or more layer directories |
+| `lib_layered_config generate-examples` | Scaffold example trees (POSIX/Windows layouts)        |
+| `lib_layered_config env-prefix`        | Compute the canonical environment prefix              |
+| `lib_layered_config fail`              | Intentionally raise a `RuntimeError` (for testing)    |
+
+### `read`
+
+```bash
+lib_layered_config read --vendor Acme --app ConfigKit --slug config-kit   --prefer toml --prefer json   --start-dir /path/to/project   --default-file ./config.defaults.toml   --format human            # or json
+  # --provenance / --no-provenance (defaults to provenance)
+```
+
+- `--format human` prints an annotated prose list (default).
+- `--format json` returns either the Config JSON or, with `--provenance`, a combined `{config, provenance}` document. Pretty-printing is enabled by default; add `--no-indent` for compact output.
+- `--default-file` seeds the merge with a lowest-precedence baseline file.
+
+Human output example:
+
+```
+service.timeout: 20
+  provenance: layer=env, path=None
+service.endpoint: https://api.example.com
+  provenance: layer=user, path=/home/alice/.config/config-kit/config.toml
+```
+
+JSON output example:
+
+```bash
+lib_layered_config read --vendor Acme --app ConfigKit --slug config-kit --format json --indent
+```
+
+### `deploy`
+
+```bash
+lib_layered_config deploy --source ./config/app.toml   --vendor Acme --app ConfigKit --slug config-kit   --target app --target user [--platform posix|windows] [--force]
+```
+
+Returns a JSON array of files created or overwritten.
+
+### `generate-examples`
+
+```bash
+lib_layered_config generate-examples --destination ./examples   --vendor Acme --app ConfigKit --slug config-kit [--platform posix|windows] [--force]
+```
+
+### `env-prefix`
+
+```bash
+lib_layered_config env-prefix config-kit
+# -> CONFIG_KIT
+```
+
+### `read-json`
+
+```bash
+lib_layered_config read-json --vendor Acme --app ConfigKit --slug config-kit --no-indent
+```
+
+### `fail`
+
+```bash
+lib_layered_config fail
+# raises RuntimeError: i should fail
+```
+
+## Python API
+
+```python
+from lib_layered_config import (
+    Config,
+    read_config,
+    read_config_json,
+    read_config_raw,
+    default_env_prefix,
+    deploy_config,
+    generate_examples,
+    i_should_fail,
+)
+```
+
+### `Config`
+
+- `Config.get("service.timeout", default=None)` — dotted-path lookups with optional default.
+- `Config.origin("service.timeout")` — provenance metadata (`{'layer': 'env', 'path': None, 'key': 'service.timeout'}`).
+- `Config.as_dict()` / `Config.to_json(indent=2)` — mutable deep copies for serialization.
+- `Config.with_overrides({"service": {"timeout": 90}})` — shallow overrides without mutating the original.
+
+### `read_config`
+
+Immutable `Config` wrapper with provenance metadata. See [Quick Start](#quick-start).
+
+```python
+from pathlib import Path
+from lib_layered_config import read_config
+
+defaults = Path("config.defaults.toml")
+config = read_config(vendor="Acme", app="Demo", slug="demo", default_file=defaults)
+print(config.get("service.timeout", default=30))
+```
+
+### `read_config_json`
+
+```python
+from lib_layered_config import read_config_json
+import json
+
+payload = read_config_json(vendor="Acme", app="Demo", slug="demo", indent=2)
+data = json.loads(payload)
+print(data["config"]["service"]["timeout"])
+print(data["provenance"]["service.timeout"])
+```
+
+### `read_config_raw`
+
+Returns primitive `dict` structures `(data, provenance)` for automation or templating.
+
+### Example helpers
+
+- `deploy_config(source, vendor=..., app=..., targets=("app", "user"), slug=None, platform=None, force=False)`
+- `generate_examples(destination, slug=..., vendor=..., app=..., platform=None, force=False)`
+
+## Example Generation & Deployment
+
+Use the Python helpers or CLI equivalents:
+
+```python
+from pathlib import Path
+from lib_layered_config.examples import deploy_config, generate_examples
+
+# copy one file into the system/user layers
+paths = deploy_config("./myapp/config.toml", vendor="Acme", app="ConfigKit", targets=("app", "user"))
+
+# scaffold an example tree for documentation
+examples = generate_examples(Path("./examples"), slug="config-kit", vendor="Acme", app="ConfigKit")
+```
+
+## Provenance & Observability
+
+- Every merged key stores metadata (`layer`, `path`, `key`).
+- Structured logging lives in `lib_layered_config.observability` (trace-aware `log_debug`, `log_info`, `log_error`).
+- Use `bind_trace_id("abc123")` to correlate CLI/log events with your own tracing.
+
+## Further documentation
+
+- [CHANGELOG](CHANGELOG.md) — user-facing release notes.
+- [CONTRIBUTING](CONTRIBUTING.md) — guidelines for issues, pull requests, and coding style.
+- [DEVELOPMENT](DEVELOPMENT.md) — local tooling, recommended workflow, and release checklist.
+- [Module Reference](docs/systemdesign/module_reference.md) — architecture-aligned responsibilities per module.
+- [LICENSE](LICENSE) — MIT license text.
+
+
+## Development
+
+```bash
+pip install "lib_layered_config[dev]"
+make test          # lint + type-check + pytest + coverage (fail-under=90%)
+make build         # build wheel / sdist artifacts
+make run -- --help # run the CLI via the repo entrypoint
+```
+
+*Formatting gate:* Ruff formatting runs in check mode during `make test`. Run `ruff format .` (or `pre-commit run --all-files`) before pushing and consider `pre-commit install` to keep local edits aligned.
+
+*Coverage gate:* the maintained test suite must stay ≥90% (see `pyproject.toml`). Add targeted unit tests if you extend functionality.
+
+**Platform notes**
+
+- Windows runners install `pipx` and `uv` automatically in CI; locally ensure `pipx` is on your `PATH` before running `make test` so the wheel verification step succeeds.
+- The journald prerequisite step runs only on Linux; macOS/Windows skips it, so there is no extra setup required on those platforms.
+
+### Continuous integration
+
+The GitHub Actions workflow executes three jobs:
+
+- **Test matrix** (Linux/macOS/Windows, Python 3.13 + latest 3.x) running the same pipeline as `make test`.
+- **pipx / uv verification** to prove the built wheel installs cleanly with the common Python app launchers.
+- **Notebook smoke test** that executes `notebooks/Quickstart.ipynb` to keep the tutorial in sync.
+
+Packaging-specific jobs (conda, Nix, Homebrew sync) were retired; the Python packaging metadata in `pyproject.toml` remains the single source of truth.
+
+## License
+
+MIT © Robert Nowotny

lib_layered_config-1.0.0.dist-info/RECORD

@@ -0,0 +1,39 @@
+lib_layered_config/__init__.py,sha256=nJZkUMWFr_LhE71vquCUojqIy8miwo_T4WexbRRSA0o,1578
+lib_layered_config/__main__.py,sha256=8zOwFdtTW_y8WBSefP1qYr99x3MWp6JOsTA1E0n-ceY,467
+lib_layered_config/_layers.py,sha256=21a_6pLIM2Hb-N54BAXVQxzbhmnNNXWNnJppKHl6ht4,13334
+lib_layered_config/_platform.py,sha256=eIvp_P8Cn-0meIzkxgZEQpKdgA9yU-fUYYKkp0Af1Qo,5819
+lib_layered_config/core.py,sha256=utjEdWRW8ZjNZ1J32_OlWyJDlIFCGO853fg28vPt5DE,10995
+lib_layered_config/observability.py,sha256=elxCz6pswff5RyC3NoPPVmPJNXCWpPuiN41hYDhjqOg,7500
+lib_layered_config/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lib_layered_config/testing.py,sha256=jTp90GKPpb219Ud8AEHsPhIEvDY6NDshjxjvLGi2nwg,1532
+lib_layered_config/adapters/__init__.py,sha256=lWl527Z1HZzu5Chal-TP_VtQZr-HZhH_CnMb7D3dJEA,373
+lib_layered_config/adapters/dotenv/__init__.py,sha256=Ru8fnFZtugqDHjfjOzMWNYkcf-XNZJi26O0gpB7-wzQ,38
+lib_layered_config/adapters/dotenv/default.py,sha256=ghsgSgw99k14aQxPoXXsVk_oE_maeaglj5rtH5L7i9s,12116
+lib_layered_config/adapters/env/__init__.py,sha256=EZY49s8TGhHvPWfEleRCIRc7W2eeAArpZPkaGTxUXX8,110
+lib_layered_config/adapters/env/default.py,sha256=r0SCfn24NxhVgmn5gFX07bPtTFTw-kk9AWtX0-b5rtI,13136
+lib_layered_config/adapters/file_loaders/__init__.py,sha256=V4KQJvY7xKJRMnY0cktkwj7SOILS6hO3eAfVBHP5B1k,45
+lib_layered_config/adapters/file_loaders/structured.py,sha256=sYe6QHZ3uoPUkVa86nz9-bRVdNUWTq5Bct2UsOkZt20,11198
+lib_layered_config/adapters/path_resolvers/__init__.py,sha256=-SEC9-2kwEZcW4hOrVbdfpMqmPKQ9UlI_PgvxLZ9m8I,65
+lib_layered_config/adapters/path_resolvers/default.py,sha256=7JE6xHuiplwqXptsH30m_q5PmqRHZMi7YQ8nuQSU5mk,21358
+lib_layered_config/application/__init__.py,sha256=fGbDqRVtb6tIXhdjYwL22548P1opLgau8BkzmXs_KiA,276
+lib_layered_config/application/merge.py,sha256=ZpRRQoLhFBcmubCXeXpKbOCFse1w_2GljXuCnCR-VTQ,12536
+lib_layered_config/application/ports.py,sha256=8HyqTTVlFxZurhjR805tmEV1D3MdzZdTXbjfUTSuoac,3047
+lib_layered_config/cli/__init__.py,sha256=EEFQRfAcD-cYROns2GRg84MpjEl4X6snpUnIM3ByPKU,5433
+lib_layered_config/cli/common.py,sha256=swjIGqA52jFP15Kd4AzC5QtPj5kndxeTnK8-vsJqQuY,7120
+lib_layered_config/cli/constants.py,sha256=15Cu0OfkP-iOmHTecKEDLK4YShYxgMeSWNKThAZV4DA,467
+lib_layered_config/cli/deploy.py,sha256=ZhxUbMx1rjWLwNTVDx8nfM63H7-6GFp60S6_zl2vGGg,2025
+lib_layered_config/cli/fail.py,sha256=PBuHrTvSdZ1mv-UGlZYbWUF24ii09IzQYnHqN1GR6JE,523
+lib_layered_config/cli/generate.py,sha256=32_DldxLz24usH56EniRDx75-zU6ZJQvlervp5KbkXc,1721
+lib_layered_config/cli/info.py,sha256=fnymBSMoEz_V-iZGBTpP-f8Ks7WhAJO8apnn4eU3AU4,870
+lib_layered_config/cli/read.py,sha256=8FQYV70z7N2Sk0wTd5_wIG5G9ff9Ox_8z54GJlUicGk,3427
+lib_layered_config/domain/__init__.py,sha256=cCPZPT_ba8q-nxrRjkVKvG-2yht7DDX_ZLWxDcx7ays,221
+lib_layered_config/domain/config.py,sha256=j6L9Igxyxi9emW3wlqLDZWhdNhB0R-L06DuGsiica94,13659
+lib_layered_config/domain/errors.py,sha256=811KWV98R8eF142ReSYjKZ2LXCQdys75y3SpKwWAn3E,1929
+lib_layered_config/examples/__init__.py,sha256=1ShHdxvsxIxWzRAYfOxaIeL2m9Je32B2I9bX8MUwXHw,996
+lib_layered_config/examples/deploy.py,sha256=1aHXsIzw9L94dXgi8xr_rTshaDUpezKV_csU81nkx6w,11211
+lib_layered_config/examples/generate.py,sha256=B8RgooeA3nGGXF0Zk7zU1tcmv2dZLSBTJGIHsiLOexQ,13808
+lib_layered_config-1.0.0.dist-info/METADATA,sha256=HtWFNt0ndl2Qe91FmDp9m1XtX9gap_4W2zxJPuK2b2c,16330
+lib_layered_config-1.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+lib_layered_config-1.0.0.dist-info/entry_points.txt,sha256=peN9XKyKARqvDRE-DpK4eeZRc1JeiQqPpzx4BGv_EkE,116
+lib_layered_config-1.0.0.dist-info/licenses/LICENSE,sha256=6s9SL2InRrwynPjJYiER7ONHBshbGj_yC5EBzfo7l9I,1072
+lib_layered_config-1.0.0.dist-info/RECORD,,

lib_layered_config-1.0.0.dist-info/WHEEL

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

lib_layered_config-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+lib-layered-config = lib_layered_config.cli:main
+lib_layered_config = lib_layered_config.cli:main

lib_layered_config-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Robert Nowotny
+
+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.
+