cfarewell 0.2.1__tar.gz

cfarewell-0.2.1/.gitignore

@@ -0,0 +1,10 @@
+/target/
+node_modules/
+
+# Generated release outputs
+**/dist/
+**/LICENSES/
+!LICENSES/
+*.tgz
+__pycache__/
+*.egg-info/

cfarewell-0.2.1/LICENSES/Apache-2.0.txt

@@ -0,0 +1,203 @@
+Copyright 2026 Julian Y. Richard Corbet
+
+                                 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.

cfarewell-0.2.1/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.5
+Name: cfarewell
+Version: 0.2.1
+Summary: Deterministic locale-correct valedictions for formal correspondence
+Project-URL: Homepage, https://github.com/corbet-labs/cfarewell#readme
+Project-URL: Repository, https://github.com/corbet-labs/cfarewell
+Project-URL: Issues, https://github.com/corbet-labs/cfarewell/issues
+License-Expression: Apache-2.0
+License-File: LICENSES/Apache-2.0.txt
+Keywords: correspondence,i18n,locale
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# cfarewell
+
+**The right closing line for a formal letter.**
+
+[![crates.io](https://img.shields.io/crates/v/cfarewell.svg)](https://crates.io/crates/cfarewell) [![npm](https://img.shields.io/npm/v/@corbet-labs/cfarewell.svg)](https://www.npmjs.com/package/@corbet-labs/cfarewell) [![Rust API](https://docs.rs/cfarewell/badge.svg)](https://docs.rs/cfarewell)
+
+Choose a valediction from 40 locale entries, including Swiss German, British English, French, and Japanese. Explicit wording always takes precedence over table defaults. No model or network calls.
+
+```js
+import { closing } from '@corbet-labs/cfarewell';
+
+closing('de-ch');
+// Freundliche Grüsse
+```
+
+## Install
+
+| Environment | Command |
+| --- | --- |
+| Rust / Cargo | `cargo add cfarewell` |
+| Node.js / npm | `npm install @corbet-labs/cfarewell` |
+| pnpm | `pnpm add @corbet-labs/cfarewell` |
+| Yarn | `yarn add @corbet-labs/cfarewell` |
+| Bun | `bun add @corbet-labs/cfarewell` |
+| Deno | `deno add npm:@corbet-labs/cfarewell` |
+
+The 0.2.1 JavaScript distribution includes compiled ESM, CommonJS,
+TypeScript declarations, and a standalone browser module. Node.js 20+ is
+supported; no TypeScript loader is required.
+
+```js
+// CommonJS
+const { closing } = require('@corbet-labs/cfarewell');
+```
+
+```html
+<script type="module">
+  import { closing } from 'https://cdn.jsdelivr.net/npm/@corbet-labs/cfarewell@0.2.1/dist/browser.js';
+  console.log(closing('de-ch'));
+</script>
+```
+
+Python wheels, source distributions, and CLI instructions are in the
+[installation guide](https://github.com/corbet-labs/cfarewell/blob/main/docs/installation.md).
+JSR publication and Typst availability are listed there explicitly.
+
+## Rust
+
+```rust
+use cfarewell::closing;
+
+assert_eq!(closing("de-ch", None), "Freundliche Grüsse");
+assert_eq!(closing("en-gb", None), "Yours sincerely,");
+```
+
+## Python
+
+```python
+from cfarewell import closing
+
+assert closing("de-ch") == 'Freundliche Grüsse'
+```
+
+## API
+
+| Function | Purpose |
+| --- | --- |
+| `closing(locale, override?)` | Resolve a valediction; even an empty override wins |
+| `availableLocales()` / `available_locales()` | List the 39 canonical locale codes |
+
+Locale matching is case-insensitive. Resolution tries the exact locale, then its base language, then English: `fr-be` → `fr`, `xx` → `en`. An override is returned unchanged, including an empty string. The locale table owns punctuation, so callers should not append another comma.
+
+## Correspondence family
+
+| Library | Responsibility |
+| --- | --- |
+| [cletter](https://github.com/corbet-labs/cletter) | Compose the correspondence helpers |
+| [cgreet](https://github.com/corbet-labs/cgreet) | German salutations and titles |
+| [cfarewell](https://github.com/corbet-labs/cfarewell) | Locale-specific closings |
+| [cdate](https://github.com/corbet-labs/cdate) | Calendar-date formatting |
+| [cink](https://github.com/corbet-labs/cink) | Handwritten signature images |
+
+
+## Development
+
+Behavior is defined by [the locale tables](https://github.com/corbet-labs/cfarewell/tree/main/tables)
+and [shared conformance vectors](https://github.com/corbet-labs/cfarewell/tree/main/tests/vectors).
+Rust, JavaScript, and Python run the same vectors. Selected CI checks exercise
+installed JavaScript tarballs, Python wheels and command-line entrypoints, and
+Typst packages. Release validation records the actual runtime and platform;
+Linux results do not establish native Windows or macOS coverage.
+All five Rust crates forbid unsafe code in their own source.
+
+See [the release guide](https://github.com/corbet-labs/cfarewell/blob/main/docs/releasing.md)
+for generation, verification, and publication commands.
+
+## License
+
+[Apache-2.0](https://github.com/corbet-labs/cfarewell/blob/main/LICENSES/Apache-2.0.txt), effective immediately from version 0.2.1 across all language distributions. Copyright 2026 Julian Y. Richard Corbet. Previously published versions retain their original license grants.

cfarewell-0.2.1/README.md

@@ -0,0 +1,99 @@
+# cfarewell
+
+**The right closing line for a formal letter.**
+
+[![crates.io](https://img.shields.io/crates/v/cfarewell.svg)](https://crates.io/crates/cfarewell) [![npm](https://img.shields.io/npm/v/@corbet-labs/cfarewell.svg)](https://www.npmjs.com/package/@corbet-labs/cfarewell) [![Rust API](https://docs.rs/cfarewell/badge.svg)](https://docs.rs/cfarewell)
+
+Choose a valediction from 40 locale entries, including Swiss German, British English, French, and Japanese. Explicit wording always takes precedence over table defaults. No model or network calls.
+
+```js
+import { closing } from '@corbet-labs/cfarewell';
+
+closing('de-ch');
+// Freundliche Grüsse
+```
+
+## Install
+
+| Environment | Command |
+| --- | --- |
+| Rust / Cargo | `cargo add cfarewell` |
+| Node.js / npm | `npm install @corbet-labs/cfarewell` |
+| pnpm | `pnpm add @corbet-labs/cfarewell` |
+| Yarn | `yarn add @corbet-labs/cfarewell` |
+| Bun | `bun add @corbet-labs/cfarewell` |
+| Deno | `deno add npm:@corbet-labs/cfarewell` |
+
+The 0.2.1 JavaScript distribution includes compiled ESM, CommonJS,
+TypeScript declarations, and a standalone browser module. Node.js 20+ is
+supported; no TypeScript loader is required.
+
+```js
+// CommonJS
+const { closing } = require('@corbet-labs/cfarewell');
+```
+
+```html
+<script type="module">
+  import { closing } from 'https://cdn.jsdelivr.net/npm/@corbet-labs/cfarewell@0.2.1/dist/browser.js';
+  console.log(closing('de-ch'));
+</script>
+```
+
+Python wheels, source distributions, and CLI instructions are in the
+[installation guide](https://github.com/corbet-labs/cfarewell/blob/main/docs/installation.md).
+JSR publication and Typst availability are listed there explicitly.
+
+## Rust
+
+```rust
+use cfarewell::closing;
+
+assert_eq!(closing("de-ch", None), "Freundliche Grüsse");
+assert_eq!(closing("en-gb", None), "Yours sincerely,");
+```
+
+## Python
+
+```python
+from cfarewell import closing
+
+assert closing("de-ch") == 'Freundliche Grüsse'
+```
+
+## API
+
+| Function | Purpose |
+| --- | --- |
+| `closing(locale, override?)` | Resolve a valediction; even an empty override wins |
+| `availableLocales()` / `available_locales()` | List the 39 canonical locale codes |
+
+Locale matching is case-insensitive. Resolution tries the exact locale, then its base language, then English: `fr-be` → `fr`, `xx` → `en`. An override is returned unchanged, including an empty string. The locale table owns punctuation, so callers should not append another comma.
+
+## Correspondence family
+
+| Library | Responsibility |
+| --- | --- |
+| [cletter](https://github.com/corbet-labs/cletter) | Compose the correspondence helpers |
+| [cgreet](https://github.com/corbet-labs/cgreet) | German salutations and titles |
+| [cfarewell](https://github.com/corbet-labs/cfarewell) | Locale-specific closings |
+| [cdate](https://github.com/corbet-labs/cdate) | Calendar-date formatting |
+| [cink](https://github.com/corbet-labs/cink) | Handwritten signature images |
+
+
+## Development
+
+Behavior is defined by [the locale tables](https://github.com/corbet-labs/cfarewell/tree/main/tables)
+and [shared conformance vectors](https://github.com/corbet-labs/cfarewell/tree/main/tests/vectors).
+Rust, JavaScript, and Python run the same vectors. Selected CI checks exercise
+installed JavaScript tarballs, Python wheels and command-line entrypoints, and
+Typst packages. Release validation records the actual runtime and platform;
+Linux results do not establish native Windows or macOS coverage.
+All five Rust crates forbid unsafe code in their own source.
+
+See [the release guide](https://github.com/corbet-labs/cfarewell/blob/main/docs/releasing.md)
+for generation, verification, and publication commands.
+
+## License
+
+[Apache-2.0](https://github.com/corbet-labs/cfarewell/blob/main/LICENSES/Apache-2.0.txt), effective immediately from version 0.2.1 across all language distributions. Copyright 2026 Julian Y. Richard Corbet. Previously published versions retain their original license grants.

cfarewell-0.2.1/cfarewell/__init__.py

@@ -0,0 +1,21 @@
+"""Locale-correct valedictions with explicit override support."""
+
+from ._tables import TABLES
+
+_TABLE = TABLES["closing"]
+_KEYS = {key.lower(): key for key in _TABLE["locales"]}
+__all__ = ["closing", "available_locales"]
+
+
+def closing(locale: str, override_closing: str | None = None) -> str:
+    """Resolve exact locale, base language, then English; an override wins."""
+    if override_closing is not None:
+        return override_closing
+    lowered = locale.lower()
+    key = _KEYS.get(lowered, _KEYS.get(lowered.split("-", 1)[0], _TABLE["fallback"]))
+    return _TABLE["locales"][key]
+
+
+def available_locales() -> list[str]:
+    """Sorted canonical BCP 47 codes in the valediction table."""
+    return sorted(_TABLE["locales"])

cfarewell-0.2.1/cfarewell/__main__.py

@@ -0,0 +1,50 @@
+"""JSON command-line bridge for callers in any programming language."""
+import argparse
+import base64
+import dataclasses
+import json
+import sys
+import cfarewell as api
+
+
+def _json_default(value):
+    if dataclasses.is_dataclass(value):
+        return dataclasses.asdict(value)
+    if isinstance(value, bytes):
+        return base64.b64encode(value).decode("ascii")
+    raise TypeError(f"Cannot serialize {type(value).__name__}")
+
+
+def _reject_constant(value):
+    raise ValueError(f"{value} is not a JSON number")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Call cfarewell functions with JSON arguments.")
+    parser.add_argument("function", choices=api.__all__)
+    parser.add_argument("arguments", nargs="?", default="[]", help="JSON array of positional arguments or object of keyword arguments; '-' reads UTF-8 stdin")
+    args = parser.parse_args()
+    try:
+        values = json.loads(sys.stdin.buffer.read().decode("utf-8") if args.arguments == "-" else args.arguments, parse_constant=_reject_constant)
+        if not isinstance(values, (list, dict)):
+            raise ValueError("arguments must be a JSON array or object")
+        # Image operations accept the JSON object returned by normalize.
+        if args.function in ("exceeds_limits", "scale_to_fit", "signature_size"):
+            raw = values[0] if isinstance(values, list) else values["image"]
+            if isinstance(raw, dict):
+                raw = dict(raw)
+                raw["bytes"] = base64.b64decode(raw["bytes"], validate=True)
+                image = api.DecodedImage(**raw)
+                if isinstance(values, list):
+                    values[0] = image
+                else:
+                    values["image"] = image
+        fn = getattr(api, args.function)
+        result = fn(*values) if isinstance(values, list) else fn(**values)
+        print(json.dumps(result, default=_json_default, ensure_ascii=True, allow_nan=False))
+    except (ValueError, TypeError, KeyError, IndexError, AttributeError, OverflowError) as error:
+        parser.error(str(error))
+
+
+if __name__ == "__main__":
+    main()

cfarewell-0.2.1/cfarewell/_tables.py

@@ -0,0 +1,42 @@
+# Generated by scripts/sync-python.py; edit tables/*.json instead.
+TABLES = {'closing': {'locales': {'de': 'Mit freundlichen Grüßen',
+                         'de-ch': 'Freundliche Grüsse',
+                         'de-li': 'Freundliche Grüsse',
+                         'de-at': 'Mit freundlichen Grüßen',
+                         'en': 'Yours sincerely,',
+                         'en-gb': 'Yours sincerely,',
+                         'en-us': 'Sincerely,',
+                         'fr': 'Veuillez agréer, Madame, Monsieur, mes salutations distinguées.',
+                         'fr-ch': 'Meilleures salutations,',
+                         'it': 'Cordiali saluti,',
+                         'it-ch': 'Cordiali saluti,',
+                         'es': 'Atentamente,',
+                         'es-mx': 'Atentamente,',
+                         'pt': 'Atenciosamente,',
+                         'pt-br': 'Atenciosamente,',
+                         'nl': 'Met vriendelijke groet,',
+                         'nl-be': 'Met vriendelijke groeten,',
+                         'ar': 'مع أطيب التحيات،',
+                         'bg': 'С уважение,',
+                         'cs': 'S pozdravem,',
+                         'da': 'Med venlig hilsen,',
+                         'el': 'Με εκτίμηση,',
+                         'et': 'Lugupidamisega,',
+                         'fi': 'Ystävällisin terveisin,',
+                         'hu': 'Tisztelettel,',
+                         'id': 'Hormat saya,',
+                         'ja': '敬具',
+                         'ko': '감사합니다.',
+                         'lt': 'Pagarbiai,',
+                         'lv': 'Ar cieņu,',
+                         'nb': 'Med vennlig hilsen,',
+                         'pl': 'Z poważaniem,',
+                         'ro': 'Cu stimă,',
+                         'ru': 'С уважением,',
+                         'sk': 'S pozdravom,',
+                         'sl': 'S spoštovanjem,',
+                         'sv': 'Med vänliga hälsningar,',
+                         'tr': 'Saygılarımla,',
+                         'uk': 'З повагою,',
+                         'zh': '此致敬礼'},
+             'fallback': 'en'}}

cfarewell-0.2.1/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["hatchling>=1.27,<2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "cfarewell"
+version = "0.2.1"
+description = "Deterministic locale-correct valedictions for formal correspondence"
+readme = "README.md"
+license = "Apache-2.0"
+license-files = ["LICENSES/*"]
+requires-python = ">=3.10"
+keywords = ["i18n", "correspondence", "locale"]
+classifiers = ["Programming Language :: Python :: 3", "Operating System :: OS Independent"]
+
+
+[project.urls]
+Homepage = "https://github.com/corbet-labs/cfarewell#readme"
+Repository = "https://github.com/corbet-labs/cfarewell"
+Issues = "https://github.com/corbet-labs/cfarewell/issues"
+
+[project.scripts]
+cfarewell = "cfarewell.__main__:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["cfarewell"]

cfarewell-0.2.1/scripts/conformance.py

@@ -0,0 +1,56 @@
+"""Run canonical vectors against either the source port or an installed wheel."""
+import base64
+import importlib
+import json
+from pathlib import Path
+import sys
+
+ROOT = Path(__file__).resolve().parents[2]
+if "--installed" not in sys.argv:
+    sys.path.insert(0, str(ROOT / "py"))
+api = importlib.import_module("cfarewell")
+
+ARGUMENTS = {
+    "region_parse": ["input"], "region_uses_comma": ["input"],
+    "salutation_last_name": ["input"], "salutation_honorific": ["input"],
+    "salutation_titles": ["input"], "salutation_surname": ["input"],
+    "de_salutation": ["input", "region"],
+    "recipient_salutation_warning": ["location", "input"],
+    "de_honorific_warning": ["location", "input"],
+    "closing": ["locale", "override"], "available_locales": [],
+    "long_date": ["locale", "year", "month", "day"],
+    "medium_date": ["locale", "year", "month", "day"],
+    "short_date": ["locale", "year", "month", "day"],
+    "month_year": ["locale", "year", "month"], "is_supported": ["locale"],
+    "supported_formats": [], "normalize": ["input"],
+    "exceeds_limits": ["image", "max_pixels"], "scale_to_fit": ["image", "max_pixels"],
+    "signature_size": ["image", "height_pt", "max_width_pt"],
+    "image_snippet": ["path", "height_pt", "width_pt"],
+    "resolve_locale": ["language", "location"],
+    "opening": ["locale", "person", "override"],
+    "subject": ["locale", "title", "prefix_override"],
+    "salutation": ["locale", "person"], "apply_ortho": ["locale", "text"],
+    "warnings": ["location", "locale", "person"],
+}
+
+files = sorted((ROOT / "tests/vectors").glob("*.json"))
+assert files, "No conformance vectors"
+count = 0
+for file in files:
+    for vector in json.loads(file.read_text(encoding="utf-8")):
+        name = vector["fn"]
+        values = dict(vector)
+        if "fixture" in vector:
+            values["input"] = base64.b64encode((ROOT / "tests/fixtures" / vector["fixture"]).read_bytes()).decode("ascii")
+            if name != "normalize":
+                values["image"] = api.normalize(values["input"])
+        fn = getattr(api, "parse_region" if name == "region_parse" else name)
+        actual = fn(*(values.get(key) for key in ARGUMENTS[name]))
+        if name == "normalize" and actual is not None:
+            actual = {key: getattr(actual, key) for key in ("mime", "width", "height")}
+        if isinstance(actual, tuple):
+            actual = list(actual)
+        if actual != vector["expected"]:
+            raise AssertionError(f"{file.name} :: {vector['name']}: {actual!r} != {vector['expected']!r}")
+        count += 1
+print(f"Python cfarewell: {count} vectors passed across {len(files)} files")

cfarewell-0.2.1/scripts/consumer.py

@@ -0,0 +1,104 @@
+"""Verify wheel/sdist contents and installed Python/console entrypoints.
+
+Run with the interpreter in a fresh environment containing the wheel and its
+declared dependencies. This script never adds the source package to sys.path.
+"""
+import argparse
+import base64
+from email.parser import BytesParser
+import importlib
+import importlib.metadata
+import json
+import os
+from pathlib import Path
+import subprocess
+import sys
+import tarfile
+import tempfile
+import zipfile
+
+ROOT = Path(__file__).resolve().parents[2]
+PACKAGES = [path.name for path in (ROOT / "py").iterdir() if (path / "__init__.py").is_file()]
+if len(PACKAGES) != 1:
+    raise RuntimeError("Expected exactly one source package")
+NAME = PACKAGES[0]
+CASES = {
+    "cgreet": ("de_salutation", ["Frau Dr. Müller", "ch"],
+               {"name": "Frau Dr. Müller", "region": "ch"}, "Sehr geehrte Frau Dr. Müller"),
+    "cfarewell": ("closing", ["DE-LI"], {"locale": "DE-LI"}, "Freundliche Grüsse"),
+    "cdate": ("long_date", ["EN-GB", 2026, 9, 7],
+              {"locale": "EN-GB", "year": 2026, "month": 9, "day": 7}, "7 September 2026"),
+    "cink": ("image_snippet", ["signature.png", 20],
+             {"path": "signature.png", "height_pt": 20}, '#image("signature.png", height: 20pt)'),
+    "cletter": ("salutation", ["DE-LI", "Frau Dr. Müller"],
+                {"locale": "DE-LI", "name": "Frau Dr. Müller"}, "Sehr geehrte Frau Dr. Müller"),
+}
+
+
+def check(condition, message):
+    if not condition:
+        raise AssertionError(message)
+
+
+parser = argparse.ArgumentParser(description=__doc__)
+parser.add_argument("--wheel", type=Path, required=True)
+parser.add_argument("--sdist", type=Path, required=True)
+args = parser.parse_args()
+licenses = {path.name: path.read_bytes() for path in (ROOT / "LICENSES").iterdir() if path.is_file()}
+check(bool(licenses), "Source licenses are missing")
+with zipfile.ZipFile(args.wheel) as wheel:
+    files = wheel.namelist()
+    check(f"{NAME}/py.typed" in files, "Wheel is missing py.typed")
+    metadata_paths = [path for path in files if path.endswith(".dist-info/METADATA")]
+    check(len(metadata_paths) == 1, "Expected one wheel distribution")
+    metadata = BytesParser().parsebytes(wheel.read(metadata_paths[0]))
+    check(metadata["Name"] == NAME, "Wheel package name differs from repository")
+    for name, expected in licenses.items():
+        check(any(path.endswith("/LICENSES/" + name) and wheel.read(path) == expected for path in files),
+              f"Wheel is missing the original {name}")
+with tarfile.open(args.sdist, "r:gz") as sdist:
+    files = {member.name: member for member in sdist.getmembers() if member.isfile()}
+    for name, expected in licenses.items():
+        check(any(path.endswith("/LICENSES/" + name) and sdist.extractfile(member).read() == expected
+                  for path, member in files.items()), f"Source distribution is missing {name}")
+
+distribution = importlib.metadata.distribution(NAME)
+check(distribution.version == metadata["Version"], "Installed version differs from wheel")
+check(any(entry.group == "console_scripts" and entry.name == NAME and entry.value == f"{NAME}.__main__:main"
+          for entry in distribution.entry_points), "Missing console entrypoint metadata")
+api = importlib.import_module(NAME)
+check(not Path(api.__file__).resolve().is_relative_to(ROOT / "py"), "Imported source tree instead of installed wheel")
+entrypoint = Path(sys.executable).parent / (NAME + (".exe" if os.name == "nt" else ""))
+check(entrypoint.is_file(), "Installer did not create the console entrypoint")
+function, positional, keywords, expected = CASES[NAME]
+
+with tempfile.TemporaryDirectory(prefix=f"{NAME}-python-consumer-") as cwd:
+    def call(command, function, values, *, stdin=False, valid=True):
+        payload = values if isinstance(values, str) else json.dumps(values, ensure_ascii=False)
+        result = subprocess.run(command + [function, "-" if stdin else payload],
+                                input=payload if stdin else None, cwd=cwd, text=True,
+                                encoding="utf-8", capture_output=True, timeout=30)
+        if valid:
+            check(result.returncode == 0, result.stderr)
+            return json.loads(result.stdout)
+        check(result.returncode == 2 and not result.stdout and "Traceback" not in result.stderr,
+              f"Invalid arguments did not produce a clean CLI error: {result}")
+
+    for command in ([sys.executable, "-m", NAME], [str(entrypoint)]):
+        check(call(command, function, positional) == expected, "Positional JSON invocation failed")
+        check(call(command, function, keywords, stdin=True) == expected, "Keyword/stdin invocation failed")
+        call(command, function, "null", valid=False)
+        call(command, function, "[NaN]", valid=False)
+        call(command, function, [], valid=False)
+    if NAME in ("cink", "cletter"):
+        encoded = base64.b64encode(b'<svg xmlns="http://www.w3.org/2000/svg"/>').decode("ascii")
+        decoded = call([str(entrypoint)], "normalize", [encoded])
+        check(decoded["bytes"] == encoded and decoded["mime"] == "svg", "Image JSON output lost encoded bytes")
+        check(call([str(entrypoint)], "signature_size", {"image": decoded, "height_pt": 20}) is None,
+              "Image JSON output cannot be used as a subsequent input")
+        raster = {"mime": "png", "width": 1, "height": 1, "bytes": ""}
+        check(call([str(entrypoint)], "signature_size", {"image": raster, "height_pt": 10**400}) is None,
+              "An unrepresentable height escaped the JSON bridge")
+        check(call([str(entrypoint)], "signature_size", {"image": raster, "height_pt": 20, "max_width_pt": 10**400}) is None,
+              "An unrepresentable maximum width escaped the JSON bridge")
+print(f"Python {NAME}: installed module, console JSON calls, wheel/sdist licenses and metadata passed")